> ## Documentation Index > Fetch the complete documentation index at: https://docs.baselayer.com/llms.txt > Use this file to discover all available pages before exploring further. # List the businesses your organization has verified > Lists every business your organization holds a `bus_` reference for, most recently onboarded first: its registered name, what your latest evaluation concluded, and how its operators stand. Operator counts are reported per link status rather than collapsed into one verdict — a business can have settled operators and one awaiting review at the same time. Search by reference, EIN, or name. ## OpenAPI ````yaml /api-reference/openapi.json get /identities/businesses openapi: 3.1.0 info: title: baselayer-api-service version: 0.1.0 servers: - url: https://api.baselayer.com/ security: [] paths: /identities/businesses: get: tags: - Identities summary: List the businesses your organization has verified description: >- Lists every business your organization holds a `bus_` reference for, most recently onboarded first: its registered name, what your latest evaluation concluded, and how its operators stand. Operator counts are reported per link status rather than collapsed into one verdict — a business can have settled operators and one awaiting review at the same time. Search by reference, EIN, or name. operationId: list_businesses parameters: - name: limit in: query required: false schema: type: integer maximum: 1000 minimum: 1 description: >- Maximum number of records to return in a single page. Must be between 1 and 1000. default: 10 title: Limit description: >- Maximum number of records to return in a single page. Must be between 1 and 1000. - name: offset in: query required: false schema: anyOf: - type: integer minimum: 0 - type: 'null' description: >- Number of records to skip from the beginning. Use 0 for the first page. Cannot be used with cursor. title: Offset description: >- Number of records to skip from the beginning. Use 0 for the first page. Cannot be used with cursor. - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Opaque pagination cursor token that identifies the position in the result set. Use the cursor from the previous response to get the next page. Cannot be used with offset. title: Cursor description: >- Opaque pagination cursor token that identifies the position in the result set. Use the cursor from the previous response to get the next page. Cannot be used with offset. - name: kyb_outcome in: query required: false schema: anyOf: - $ref: '#/components/schemas/BusinessKybOutcome' - type: 'null' description: >- Only businesses whose latest evaluation by your organization reached this outcome. title: Kyb Outcome description: >- Only businesses whose latest evaluation by your organization reached this outcome. - name: operator_link_status in: query required: false schema: anyOf: - $ref: '#/components/schemas/BusinessOperatorLinkStatus' - type: 'null' description: >- Only businesses with at least one covered operator link in this status. title: Operator Link Status description: >- Only businesses with at least one covered operator link in this status. - name: mint_failed_since in: query required: false schema: anyOf: - format: date-time type: string - type: 'null' description: >- Only businesses your active application saw a typed credential mint refusal for at or after this instant — the counterparty mint's refusals, which name a business and no person, and the business mints' refusals, which name both. Must carry a UTC offset. title: Mint Failed Since description: >- Only businesses your active application saw a typed credential mint refusal for at or after this instant — the counterparty mint's refusals, which name a business and no person, and the business mints' refusals, which name both. Must carry a UTC offset. - name: search in: query required: false schema: anyOf: - type: string maxLength: 200 - type: 'null' description: >- A `bus_` reference, or free text matched against the registered business name; nine digits also match as an exact EIN. title: Search description: >- A `bus_` reference, or free text matched against the registered business name; nine digits also match as an exact EIN. responses: '200': description: >- Paginated businesses, most recently onboarded first, scoped to the calling organization. content: application/json: schema: type: array items: $ref: '#/components/schemas/v1.BusinessListItemResponse' application/vnd.baselayer.v1+json: schema: type: array items: $ref: '#/components/schemas/v1.BusinessListItemResponse' headers: X-Total-Count: description: Total number of records matching the query. schema: type: integer X-Total-Pages: description: Total number of pages available based on the current limit. schema: type: integer X-Next-Cursor: description: >- Cursor for the next page (only present when using the keyset pagination and if `has_more` is true. schema: type: string '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: BusinessKybOutcome: description: |- What the organization's latest covering evaluation concluded about a business. Sourced from ``BusinessOperatorLinkConfirmation.kyb_verified``, which is tri-state on purpose: INDETERMINATE means no determination was reached (the check never ran, or the registry was silent), which is not the same claim as NOT_VERIFIED — the business was checked and did not verify. enum: - VERIFIED - NOT_VERIFIED - INDETERMINATE title: BusinessKybOutcome type: string BusinessOperatorLinkStatus: description: |- Status of the link between a person (principal) and a business they operate. VERIFIED is earned by the full evidence recipe (TIN provided + IRS-matched + KYB-verified) or granted by manual review; UNDER_REVIEW is every automatic shortfall; REJECTED is a manual refusal. A rejected link is immutable — a later submission evaluates the pair fresh. enum: - VERIFIED - UNDER_REVIEW - REJECTED title: BusinessOperatorLinkStatus type: string v1.BusinessListItemResponse: description: |- One business in ``GET /identities/businesses``. Population rule: a business appears once this organization holds a pairwise reference for it, which the directory mints for any business it covers an operator link to. Operator counts are reported per status rather than collapsed into one verdict — a business with settled operators and one awaiting review is both. properties: business_ref: description: This organization's pairwise reference to the business. title: Business Ref type: string legal_name: description: The business's registered legal name. title: Legal Name type: string kyb_outcome: $ref: '#/components/schemas/v1.BusinessKybOutcome' description: >- What this organization's most recent covering evaluation concluded. INDETERMINATE means no determination was reached — including a business it has never covered — which is not the same as NOT_VERIFIED. verified_people_count: description: Covered operator links in VERIFIED — people who can mint. title: Verified People Count type: integer under_review_people_count: description: >- Covered operator links in UNDER_REVIEW — business mints for these people are refused until a reviewer decides. title: Under Review People Count type: integer rejected_people_count: description: Covered operator links a reviewer rejected. title: Rejected People Count type: integer last_verified_at: anyOf: - format: date-time type: string - type: 'null' default: null description: >- When this organization last covered the business with an evaluation of its own. title: Last Verified At linked_people_count: description: Operator links this organization covers, in any status. readOnly: true title: Linked People Count type: integer required: - business_ref - legal_name - kyb_outcome - verified_people_count - under_review_people_count - rejected_people_count - linked_people_count title: BusinessListItemResponse (v1) type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError v1.BusinessKybOutcome: description: |- What the organization's latest covering evaluation concluded about a business. Sourced from ``BusinessOperatorLinkConfirmation.kyb_verified``, which is tri-state on purpose: INDETERMINATE means no determination was reached (the check never ran, or the registry was silent), which is not the same claim as NOT_VERIFIED — the business was checked and did not verify. enum: - VERIFIED - NOT_VERIFIED - INDETERMINATE title: BusinessKybOutcome type: string ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: APIKeyHeader: type: apiKey in: header name: X-API-Key ````