# Legacy company list

`GET https://ulawk.com/api/v1/companies`

Kept from the first version and still working. Use `/api/v1/sirketler/` for new integrations. Does not accept sandbox keys.

> Legacy: do not use in new integrations.

## Authentication

Two headers on every request: `X-API-Key` and `X-API-Secret`.

## Response

### 200 — Companies.

- `count` (integer, zorunlu)
- `companies[]` (object[], zorunlu)
- `companies[].group_id` (integer, zorunlu)
- `companies[].unvan` (string, null, zorunlu)
- `companies[].mudurluk` (string, null, zorunlu)
- `companies[].sicil_no` (string, null, zorunlu)
- `companies[].profil_hazir` (boolean, zorunlu)

```json
{
  "count": 1,
  "companies": [
    {
      "group_id": 1234,
      "unvan": "ÖRNEK DENEME SANAYİ VE TİCARET ANONİM ŞİRKETİ",
      "mudurluk": "İSTANBUL",
      "sicil_no": "100001",
      "profil_hazir": true
    }
  ]
}
```

### 401 — Unauthorized.

- `error` (string, zorunlu)
- `detail` (string)

```json
{
  "error": "unauthorized",
  "detail": "Geçerli X-API-Key gerekli."
}
```

## Request

```bash
curl "https://ulawk.com/api/v1/companies" \
  -H "X-API-Key: ulk_DENEME_ANAHTARINIZ" \
  -H "X-API-Secret: ulsk_DENEME_GIZLI_ANAHTARINIZ"
```