---
search:
  tags:
    - Settings
    - GET
seo:
  description: >-
    Any signed in user. Returns the organisation identity, receipt, tax, and
    server… Reference for the GET /api/v1/settings endpoint in the PharmaFlow
    API.
sidebar:
  label: Read the organisation settings
  badge: GET
title: Read the organisation settings
type: openapi-operation
---
Any signed in user. Returns the organisation identity, receipt, tax, and server address. A pharmacy that never saved settings still gets a full row filled with shipped defaults.

`GET /api/v1/settings`

**Responses**

- `200` — The organisation settings
- `401` — Not authenticated

Response example, 200:

```json
{
  "id": "string",
  "name": "string",
  "legal_name": "string",
  "logo_key": "string",
  "logo_url": "string",
  "phone": "string",
  "email": "string",
  "address": "string",
  "tin": "string",
  "vat_number": "string",
  "nda_license_no": "string",
  "premise_no": "string",
  "receipt_header": "string",
  "receipt_footer": "string",
  "return_policy": "string",
  "show_vat_breakdown": true,
  "show_pharmacist_on_receipt": true,
  "default_low_stock_threshold": -9007199254740991,
  "expiry_warning_days": "string",
  "auto_print_receipt": true,
  "default_copies": -9007199254740991,
  "tax_enabled": true,
  "tax_rate": 0,
  "base_currency": "string",
  "rate_staleness_days": -9007199254740991,
  "server_mode": "hosted",
  "server_url": "string",
  "updated_by": "string",
  "updated_at": "string"
}
```