> ## Documentation Index > Fetch the complete documentation index at: https://api.docs.originone.ai/llms.txt > Use this file to discover all available pages before exploring further. # List companies > Returns the companies linked to the API token, ordered by name. Requires the `company.list` scope. ## OpenAPI ````yaml api-reference/openapi.json GET /api/v2/companies openapi: 3.1.0 info: title: Origin One API description: REST API for integrating with the Origin One platform. version: '2' contact: name: Origin One url: https://origin.one email: support@originone.ai servers: - url: https://api.stage.origin.one description: Staging - url: https://api.origin.one description: Production security: [] tags: - name: agencies description: >- Regulatory agencies and the job categories they publish; the same for every API token. - name: jobCategories description: >- Job categories an agency publishes; an order under FAA, FRA or FTA names one. - name: clinics description: Collection sites where participants are tested. - name: companies description: Companies linked to your API token. - name: locations description: Company locations. - name: orders description: >- Drug and alcohol test orders: create them and follow their services to a result. - name: packages description: Packages of services that can be ordered. - name: services description: Services available to your API token. - name: webhooks description: Events delivered to the callback URL given when an order was created. paths: /api/v2/companies: get: tags: - companies summary: List companies description: >- Returns the companies linked to the API token, ordered by name. Requires the `company.list` scope. operationId: listCompanies parameters: - name: limit required: false in: query description: Number of items per page (max 20). schema: default: 10 type: integer minimum: 1 maximum: 20 description: Number of items per page (max 20). example: 10 - name: page required: false in: query description: Page of results to return (1-based). schema: default: 1 type: integer minimum: 1 maximum: 10000 description: Page of results to return (1-based). example: 1 - name: name required: false in: query description: Filter by company name (case-insensitive partial match). schema: type: string minLength: 1 maxLength: 255 description: Filter by company name (case-insensitive partial match). example: acme responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/CompanyList' '400': description: The request failed validation. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: The bearer token is missing, invalid, or expired. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: The API token lacks the required scope. content: application/json: schema: $ref: '#/components/schemas/Error' default: description: Unexpected error. content: application/json: schema: $ref: '#/components/schemas/Error' security: - bearer: [] components: schemas: CompanyList: type: object properties: data: type: array items: $ref: '#/components/schemas/Company' description: Items on this page. limit: type: integer description: Number of items per page. example: 10 page: type: integer description: Current page number (1-based). example: 1 total: type: integer description: Number of matching items across all pages. example: 1 required: - data - limit - page - total Error: type: object properties: error: type: string description: HTTP status reason phrase. example: Bad Request errors: type: array items: type: object properties: code: anyOf: - type: string enum: - backgroundCheckIntegrationNotConfigured - badRequest - conflict - insufficientScope - internalError - invalidElement - invalidFormat - invalidKey - invalidScheduleStrategy - invalidState - invalidType - invalidUnion - invalidValue - linkRequiredBackground - notFound - notMultipleOf - required - scheduleClinicExcludedByFeeCap - scheduleConfiguredClinicUnavailable - tooBig - tooManyRequests - tooSmall - unauthenticated - unrecognizedKeys - type: string description: >- Machine-readable error code. New codes may be added; treat unknown codes by `statusCode`. example: tooSmall detail: type: string description: Human-readable explanation. example: 'Too small: expected number to be >=1' meta: description: Additional machine-readable context. type: object propertyNames: type: string additionalProperties: {} source: description: Present only when a request field is at fault. type: object properties: pointer: type: string description: JSON pointer to the request field at fault. example: /page required: - pointer required: - code - detail description: One entry per problem found. statusCode: type: integer description: HTTP status code. example: 400 required: - error - errors - statusCode Company: type: object properties: id: type: string description: Unique identifier of the company. example: '123' name: type: string description: Company name. example: Acme Inc object: type: string description: Object type; always `company`. example: company enum: - company address: anyOf: - $ref: '#/components/schemas/Address' - type: 'null' description: Postal address; null when the company has none. createdAt: format: date-time type: string description: When the company was created. example: '2025-01-15T10:30:00.000Z' phone: description: Primary phone number. example: +1-206-555-0123 type: - string - 'null' url: type: string description: Canonical path of this resource, relative to the API origin. example: /api/v2/companies/123 format: uri-reference required: - id - name - object - address - createdAt - phone - url Address: type: object properties: city: description: City or town. example: Seattle type: - string - 'null' country: description: Country code. example: US type: - string - 'null' line1: description: First line of the street address. example: 123 Main St type: - string - 'null' line2: description: Second line of the street address. example: Suite 400 type: - string - 'null' object: type: string description: Object type; always `address`. example: address enum: - address postalCode: description: Postal or ZIP code. example: '98101' type: - string - 'null' state: description: State or region code. example: WA type: - string - 'null' required: - city - country - line1 - line2 - object - postalCode - state securitySchemes: bearer: description: >- Origin One API token. Pass it in the Authorization header: `Authorization: Bearer `. scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.