> For the complete documentation index, see [llms.txt](https://docs.adaptria.locaria.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adaptria.locaria.com/internal-api/reference/companies.md).

# 🏢 Companies

### Companies

Companies represent the client organizations that your API credentials have access to.

#### When to Use This

Use this endpoint to:

* See which companies you can create RFQs for
* Get company IDs needed for RFQ creation
* Verify your company associations

#### Using Company IDs

When creating an RFQ, you must specify the `companyId` field. This identifies which company the RFQ belongs to. You can only create RFQs for companies that your API credentials have access to.

Get available companies from the endpoints below.

## 🏢 Get Your Companies

> \## Get Companies You Have Access To\
> \
> Retrieve the list of companies (clients) that your user account is associated with.\
> \
> \### When to Use This\
> \
> Use this endpoint to:\
> \- See which companies you can create RFQs for\
> \- Get company IDs needed for API requests\
> \- Verify your company associations\
> \
> \### Response Fields\
> \
> \| Field | Description |\
> \|-------|-------------|\
> \| \`id\` | Unique identifier (UUID) for the company |\
> \| \`name\` | Full company name |\
> \| \`shortCode\` | Short identifier code (optional) |\
> \| \`clientType\` | Type: \`direct\_client\`, \`agency\`, or \`subsidiary\` |\
> \
> \### Using Company IDs\
> \
> When creating RFQs, the company context is automatically determined from your API token. However, if you have access to multiple companies, you may need to specify which company the RFQ belongs to.

```json
{"openapi":"3.1.0","info":{"title":"Adaptria Public API: Connector","version":"1.0.0"},"tags":[{"name":"🏢 Companies","description":"## Companies\n\nCompanies represent the client organizations that your API credentials have access to.\n\n### When to Use This\n\nUse this endpoint to:\n- See which companies you can create RFQs for\n- Get company IDs needed for RFQ creation\n- Verify your company associations\n\n### Using Company IDs\n\nWhen creating an RFQ, you must specify the `companyId` field. This identifies which company the RFQ belongs to. You can only create RFQs for companies that your API credentials have access to.\n\nGet available companies from the endpoints below.\n"}],"servers":[{"url":"https://api.adaptria.locaria.com","description":"Production Environment"}],"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Api-key","description":"## API Key Authentication\n\nStatic API key obtained from the Adaptria Portal or via `POST /api/credentials/api-keys`.\n\n**How to authenticate**:\n1. Generate an API key from the Adaptria Portal (Settings → API Keys) or ask your admin\n2. Include the key in all requests using the `Api-key` header\n\n**Key format**: `lla_live_<32-character-string>`\n\n**No token exchange needed** — the key is used directly in every request. Revoke or rotate keys from the portal."},"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"## Auth0 Bearer Token\n\nFor first-party clients that already authenticate against Auth0, send the JWT in\nthe `Authorisation` header as `Bearer <token>`."}},"schemas":{"GetCompaniesResponse":{"type":"object","properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"companies":{"type":"array","items":{"$ref":"#/components/schemas/PublicCompany"},"description":"List of companies the user has access to"}},"required":["companies"],"description":"Company data"}},"required":["success","data"]},"PublicCompany":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the company"},"name":{"type":"string","description":"Company name"},"shortCode":{"type":"string","description":"Short code identifier for the company"},"clientType":{"type":"string","enum":["direct_client","agency","subsidiary"],"description":"Type of client:\n- `direct_client`: Direct client company\n- `agency`: Translation agency\n- `subsidiary`: Subsidiary of a parent company"}},"required":["id","name"]}}},"paths":{"/api/public/v1/client/companies":{"get":{"summary":"🏢 Get Your Companies","description":"## Get Companies You Have Access To\n\nRetrieve the list of companies (clients) that your user account is associated with.\n\n### When to Use This\n\nUse this endpoint to:\n- See which companies you can create RFQs for\n- Get company IDs needed for API requests\n- Verify your company associations\n\n### Response Fields\n\n| Field | Description |\n|-------|-------------|\n| `id` | Unique identifier (UUID) for the company |\n| `name` | Full company name |\n| `shortCode` | Short identifier code (optional) |\n| `clientType` | Type: `direct_client`, `agency`, or `subsidiary` |\n\n### Using Company IDs\n\nWhen creating RFQs, the company context is automatically determined from your API token. However, if you have access to multiple companies, you may need to specify which company the RFQ belongs to.","tags":["🏢 Companies"],"parameters":[{"name":"search","in":"query","required":false,"schema":{"type":"string"},"description":"Filter companies by name or short code"}],"responses":{"200":{"description":"Companies retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCompaniesResponse"}}}},"401":{"description":"Authentication required"},"403":{"description":"Access denied"}}}}}}
```