🏢 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

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.

Authorizations

bearerAuth

AuthorizationstringRequired

Authorisation Header Required

JWT access token obtained from POST /api/credentials/token

How to authenticate:

1. Generate API credentials from the Adaptria Portal
2. Exchange credentials for a token: POST /api/credentials/token
3. Include the token in all requests using the Authorisation header: Authorisation: Bearer <token>

Important: Use Authorisation (British English spelling with 's'), not Authorisation (American spelling with 'z').

Token Expiration: 1 hour (3600 seconds)

Query parameters

searchstringOptional

Filter companies by name or short code

Responses

200

Companies retrieved successfully

application/json

successboolean · enumRequiredPossible values:

401

Authentication required

403

Access denied

get

/api/public/v1/client/companies

HTTPcURLJavaScriptPython

GET /api/public/v1/client/companies HTTP/1.1
Host: staging.api.locate.studiographene.co.uk
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "data": {
    "companies": [
      {
        "id": "b49b4440-1e59-4270-ba17-c5653fd71546",
        "name": "Acme Corporation",
        "shortCode": "ACME",
        "clientType": "direct_client"
      }
    ]
  }
}