> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datalane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Describe the authenticated organization

Use this operation to verify authentication and plan enrichment work against the organization's current capacity.

`credits.smb` reports the balance available for account and contact enrichment. `credits.researchAgents` reports the balance available for Research Agent runs. `enrichment.enrichingAccounts` reports how many accounts are currently enriching across the organization, including campaigns launched from the UI. Subtract it from `enrichment.maxEnrichingAccounts` to get the number of accounts a new enrichment can include. The count is a point-in-time value: concurrent launches can change it between this call and a subsequent enrich.


## OpenAPI

````yaml /openapi.json post /v1/org/describe
openapi: 3.1.0
info:
  title: DataLane API
  description: Public DataLane enrichment API.
  version: 1.0.0
servers:
  - url: https://api.datalane.com
security:
  - apiKey: []
tags:
  - name: Campaigns
  - name: Organization
paths:
  /v1/org/describe:
    post:
      tags:
        - Organization
      summary: Describe the authenticated organization
      operationId: postV1OrgDescribe
      responses:
        '200':
          description: Response for status 200
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      organization:
                        type: object
                        properties:
                          id:
                            type: string
                            pattern: >-
                              ^org_[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{21}$
                          name:
                            type: string
                            examples:
                              - Acme Robotics
                        required:
                          - id
                          - name
                        additionalProperties: false
                      credits:
                        type: object
                        properties:
                          smb:
                            type: integer
                            minimum: 0
                            maximum: 9007199254740991
                            examples:
                              - 1000
                            description: >-
                              SMB enrichment credits currently available to the
                              organization.
                          researchAgents:
                            type: number
                            minimum: 0
                            examples:
                              - 500
                            description: >-
                              Research Agent credits currently available to the
                              organization.
                        required:
                          - smb
                          - researchAgents
                        additionalProperties: false
                      enrichment:
                        type: object
                        properties:
                          enrichingAccounts:
                            type: integer
                            minimum: 0
                            maximum: 9007199254740991
                            examples:
                              - 1200
                            description: >-
                              Accounts currently enriching across the
                              organization, including campaigns launched from
                              the UI. Point-in-time value; concurrent launches
                              can change it.
                          maxEnrichingAccounts:
                            type: integer
                            exclusiveMinimum: 0
                            maximum: 9007199254740991
                            examples:
                              - 10000
                            description: >-
                              Maximum accounts that may be enriching at once,
                              organization-wide.
                        required:
                          - enrichingAccounts
                          - maxEnrichingAccounts
                        additionalProperties: false
                    required:
                      - organization
                      - credits
                      - enrichment
                    additionalProperties: false
                  error:
                    type: 'null'
                required:
                  - data
                  - error
                additionalProperties: false
        '400':
          description: Response for status 400
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  data:
                    type: 'null'
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                          - invalid_request
                      message:
                        type: string
                      details:
                        type: object
                        properties:
                          issues:
                            minItems: 1
                            type: array
                            items:
                              type: string
                        required:
                          - issues
                        additionalProperties: false
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - data
                  - error
                additionalProperties: false
        '401':
          description: Response for status 401
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                anyOf:
                  - type: object
                    properties:
                      data:
                        type: 'null'
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            enum:
                              - invalid_api_key
                          message:
                            type: string
                        required:
                          - code
                          - message
                        additionalProperties: false
                    required:
                      - data
                      - error
                    additionalProperties: false
                  - type: object
                    properties:
                      data:
                        type: 'null'
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            enum:
                              - revoked_api_key
                          message:
                            type: string
                        required:
                          - code
                          - message
                        additionalProperties: false
                    required:
                      - data
                      - error
                    additionalProperties: false
        '500':
          description: Response for status 500
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  data:
                    type: 'null'
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                          - internal_error
                      message:
                        type: string
                        enum:
                          - Internal error.
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - data
                  - error
                additionalProperties: false
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      bearerFormat: DataLane API key

````