# Company Data API
> Search and look up the global register of legal entities (companies, funds, branches) by name or LEI, powered by the GLEIF Legal Entity Identifier system — roughly 2.6 million entities worldwide. Returns the official legal name, legal form, jurisdiction, registered address, entity status and registration details. Ideal for KYB, compliance, onboarding and supplier verification.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/companies-api/..."
```

## Pricing
- **Free** (Free) — 1,000 calls/Mo, 2 req/s
- **Starter** ($19/Mo) — 25,000 calls/Mo, 10 req/s
- **Pro** ($79/Mo) — 200,000 calls/Mo, 25 req/s
- **Enterprise** ($399/Mo) — 2,000,000 calls/Mo, 100 req/s

## Endpoints

### Lookup

#### `GET /v1/entity` — Full record for one entity by LEI

**Parameters:**
- `lei` (query, required, string) — 20-character Legal Entity Identifier Example: `HWUPKR0MPOU8FGXBT394`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/companies-api/v1/entity?lei=HWUPKR0MPOU8FGXBT394"
```

**Response:**
```json
{
    "data": {
        "bic": [
            "APLEUS66XXX"
        ],
        "lei": "HWUPKR0MPOU8FGXBT394",
        "status": "ACTIVE",
        "category": "GENERAL",
        "legal_form": "H1UM",
        "legal_name": "Apple Inc.",
        "other_names": [
            "Apple Computer, Inc."
        ],
        "jurisdiction": "US-CA",
        "registration": {
            "status": "ISSUED",
            "last_update": "2026-03-03T16:34:33Z",
            "initial_date": "2012-06-06T15:53:00Z",
            "managing_lou": "5493001KJTIIGC8Y1R12",
            "next_renewal": "2027-03-08T17:27:20Z"
        },
        "legal_address": {
            "city": "Glendale",
            "lines": [
                "C/O C T Corporation System",
                "330 N. Brand Blvd",
                "Suite 700"
            ],
            "region": "US-CA",
            "country": "US",
            "postal_code": "91203"
        },
        "headquarters_address": {
            "city": "Cupertino",
            "lines": [
                "One Apple Park Way"
            ],
            "region": "US-CA",
            "country": "US",
            "postal_code": "95014"
        }
    },
    "meta": {
        "timestamp": "2026-05-30T23:21:16.210Z",
        "request_id": "9c81eba9-89d7-4e06-ae31-7447fbc16bbb"
    },
    "status": "ok",
    "message": "Entity retrieved",
    "success": true
}
```

#### `GET /v1/search` — Search legal entities by name

**Parameters:**
- `q` (query, required, string) — Company / legal-entity name Example: `Apple`
- `country` (query, optional, string) — Filter by registered country (ISO-2) Example: `US`
- `status` (query, optional, string) — Filter by status: ACTIVE or INACTIVE Example: `ACTIVE`
- `page` (query, optional, string) — Page number (default 1) Example: `1`
- `page_size` (query, optional, string) — Results per page (1-100, default 10) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/companies-api/v1/search?q=Apple&country=US&status=ACTIVE&page=1&page_size=10"
```

**Response:**
```json
{
    "data": {
        "page": 1,
        "count": 10,
        "query": "Apple",
        "total": 134,
        "results": [
            {
                "bic": [
                    "APPAUS33XXX"
                ],
                "lei": "549300N1UWZ4871DND44",
                "status": "ACTIVE",
                "category": "GENERAL",
                "legal_form": "M0ER",
                "legal_name": "Apple Bank",
                "other_names": [
                    "Apple Bank for Savings"
                ],
                "jurisdiction": "US-NY",
                "registration": {
                    "status": "ISSUED",
                    "last_update": "2026-01-20T14:57:38Z",
                    "initial_date": "2014-11-21T01:59:00Z",
                    "managing_lou": "529900F6BNUR3RJ2WH29",
                    "next_renewal": "2026-10-11T19:37:39Z"
                },
                "legal_address": {
                    "city": "New York",
                    "lines": [
                        "122 E 42nd St Fl 9"
                    ],
                    "region": "US-NY",
                    "country": "US",
                    "postal_code": "10168"
                },
                "headquarters_address": {
                    "city": "New York",
                    "lines": [
                        "122 E 42nd St Fl 9"
                    ],
                    "region": "US-NY",
                    "country": "US",
                    "postal_code": "10168
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Field reference & data source

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/companies-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "fields": [
            "lei",
            "legal_name",
            "other_names",
            "legal_form",
            "jurisdiction",
            "category",
            "status",
            "legal_address",
            "headquarters_address",
            "registration",
            "bic"
        ],
        "source": "GLEIF — Global Legal Entity Identifier Foundation",
        "endpoints": {
            "/v1/entity": "Full record for one entity by its 20-character LEI.",
            "/v1/search": "Search entities by legal name; optional country (ISO-2) and status filter; paginated."
        },
        "description": "Search the worldwide LEI register of legal entities (companies, funds, branches)"
    },
    "meta": {
        "timestamp": "2026-05-30T23:21:16.540Z",
        "request_id": "cba51f47-4025-4cdd-8c78-9fbfadb539ac"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/companies-api
OpenAPI spec: https://www.oanor.com/api/companies-api/openapi.json