# Get an organisation

One organisation: description, listings, domains, industries, addresses and the latest AUM record.

Canonical: https://chikaraintel.com/docs/api/reference/organisations/get-organisation

```text
GET https://api.chikaraintel.com/v1/organisations/{organisationReference}
```

Authentication: `Authorization: Bearer <token>`.

## Parameters

- `organisationReference` (uuid, path, required) The organisation's reference.

## Response

The payload is under `success`.

- `reference` (uuid)
- `name` (string)
- `description` (string | null)
- `totals` (object) `{ employees }`.
- `size` (string) A headcount band.
- `aliases` (array) Other names, with `start_date` and `end_date`.
- `tickers` (array) `{ value, exchange, currency, status, is_primary_listing }`.
- `domains` (array) `{ domain, confidence_score, is_valid }`.
- `phones` (array) `{ number, type, is_valid }`.
- `industries` (array) `{ code, name, level, is_primary }`, GICS.
- `addresses` (object) `company` and `mailing`, each `{ city, state, country, zip_postal_code }`.
- `client_summary` (object | null) The latest AUM record. See [assets under management](/docs/concepts/assets-under-management).
  - `currency_code` (string)
  - `summary_type` (string) `client` or `fund`.
  - `publish_date` (datetime)
  - `entries` (array) `{ client_type, client_type_label, number_of_clients, fewer_than_5, regulatory_assets_under_management }`.
- `relationships` (object) Counts of `customers`, `suppliers`, `partners` and `service_providers`.
- `status` (string)
- `verified` (boolean)
- `confidence` (integer) 0 to 100.

An organisation can carry more fields than are listed here. Treat unlisted fields as unstable.

## Examples

cURL:

```bash
curl -sS "https://api.chikaraintel.com/v1/organisations/3f2a9c1e-7b4d-4e8a-9c21-5d6e7f8a9b01" \
  -H "Authorization: Bearer $CHIKARA_API_TOKEN" \
  -H "Accept: application/json"
```

JavaScript:

```javascript
const BASE = "https://api.chikaraintel.com";
const headers = {
  Authorization: `Bearer ${process.env.CHIKARA_API_TOKEN}`,
  Accept: "application/json"
};

const res = await fetch(`${BASE}/v1/organisations/3f2a9c1e-7b4d-4e8a-9c21-5d6e7f8a9b01`, { headers });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);

const { success } = await res.json();
console.log(success);
```

Python:

```python
import os
import requests

BASE = "https://api.chikaraintel.com"
HEADERS = {
    "Authorization": f"Bearer {os.environ['CHIKARA_API_TOKEN']}",
    "Accept": "application/json",
}

res = requests.get(
    f"{BASE}/v1/organisations/3f2a9c1e-7b4d-4e8a-9c21-5d6e7f8a9b01",
    headers=HEADERS,
    timeout=30,
)
res.raise_for_status()
print(res.json()["success"])
```

Response:

```json
{
  "status": {
    "code": 200,
    "messages": []
  },
  "success": {
    "reference": "3f2a9c1e-7b4d-4e8a-9c21-5d6e7f8a9b01",
    "name": "Halberd Industrial Group",
    "description": "Precision components for aerospace and energy customers.",
    "totals": {
      "employees": 3200
    },
    "size": "Large (1,001–5,000 employees)",
    "tickers": [
      {
        "value": "HLBD",
        "exchange": {
          "name": "London Stock Exchange",
          "code": "LSE"
        },
        "currency": "GBP",
        "status": "active",
        "is_primary_listing": true
      }
    ],
    "domains": [
      {
        "domain": "halberd.example",
        "confidence_score": 0.97,
        "is_valid": true
      }
    ],
    "industries": [
      {
        "code": "201060",
        "name": "Industrial Machinery",
        "level": 4,
        "is_primary": true
      }
    ],
    "client_summary": null,
    "relationships": {
      "customers": 12,
      "suppliers": 4,
      "partners": 2,
      "service_providers": 3
    },
    "status": "active",
    "verified": true,
    "confidence": 88
  },
  "correlation_id": "5f0c2a9e4b7d4c1e"
}
```

## Used by

- get_company
- get_company_aum