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

# Get account details

> Zero credits, no caller account ID or request body. unit is always credit. Grant profiles is a deprecated alias of credits. remaining excludes reservations; used counts settled credits. No data lookup. Available even without an active grant. GET /v1/account/details is the same read.

The assistant tool is `get_account_details`. Zero credits and no data lookup. The authenticated credential selects the
account; no caller account ID or request body is accepted. Read saved identity,
status and allowance expiry even without an active grant.

`unit` is always `"credit"`. `allowance.remaining` excludes pending
reservations; `used` is settled usage and `reserved` is in progress. Active grants
show `credits` and expiry. `profiles` on a grant is deprecated and equals `credits`.
`meta.profiles_used` is deprecated and is 0. Missing identity fields are null and
must not be invented.


## OpenAPI

````yaml GET /v1/account/details
openapi: 3.1.0
info:
  title: Datalayer API
  version: '2026-10-19'
  description: >-
    People and Company intelligence. New accounts receive 100 one-time trial
    credits for 14 days, no card or automatic refill. The published plan for new
    signups is USD 49/month for 1,500 shared credits with monthly expiry and no
    rollover. USD 39 manual packs buy 1,000 credits valid for 12 months,
    available to active paid subscribers. An earlier purchase keeps the
    allowance, rates and expiry recorded for that purchase. On the published
    plan, a company or people search with results costs 1 credit, and an empty
    or failed search costs zero. get_account_details and saved viewing cost
    zero. Delivered company/person profiles with requested available context
    cost one credit. A verified work email costs 2 credits, including
    verification; standalone discovery has no implicit profile charge.
    Unverified employer-associated business candidates are explicitly labelled,
    retain independent assessment and catch-all evidence, and cost zero email
    credits. Conclusive valid OR invalid standalone email checks cost one;
    catch-all/unknown/unavailable cost zero. find_job_postings costs 1 credit
    when a successful page returns at least one posting, and zero for an empty
    page or a failure. That rate does not change any other rate. get_tech_stack
    costs 1 credit when the returned page lists at least one technology, and
    zero when that page is empty or the call fails. The same domain, after a
    leading www. is removed, repeats free for 24 hours. find_sites_using_tech
    costs 1 credit when a page returns at least one site, and zero when that
    page is empty or the call fails. The identical slug, limit and offset repeat
    free for 24 hours. list_technologies costs zero and returns one cached
    directory page. These rates do not change any other rate.
    get_company_profile does not include a technology summary. Eligible
    purchased-result repeats and added profile context cost zero for 24 hours
    from the paid anchor. Former profile quantities are the same number of
    credits. REST and MCP use the same authoritative account ledger. List filter
    lookup and preview cost zero credits and do not return billable record IDs.
    build_list reserves 1 credit per 100 requested IDs, rounded up, at most
    10000 IDs, and settles on the IDs returned. Empty or failed lists release
    the reservation. Full profile enrichment stays at the existing profile
    price. Funding, mobile/app data and monitoring are excluded.
servers:
  - url: https://api.datalayer.so
    description: Production API
security:
  - bearerAuth: []
paths:
  /v1/account/details:
    get:
      summary: Read connected account identity and allowance
      description: >-
        Zero credits, no caller account ID or request body. unit is always
        credit. Grant profiles is a deprecated alias of credits. remaining
        excludes reservations; used counts settled credits. No data lookup.
        Available even without an active grant. GET /v1/account/details is the
        same read.
      operationId: get_account_details
      responses:
        '200':
          description: Connected account only.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountResponse'
components:
  schemas:
    AccountResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            account:
              type: object
              properties:
                id:
                  type: string
                  minLength: 1
                  maxLength: 160
                name:
                  anyOf:
                    - type: string
                      minLength: 1
                      maxLength: 80
                    - type: 'null'
                email:
                  anyOf:
                    - type: string
                      minLength: 3
                      maxLength: 254
                    - type: 'null'
              required:
                - id
                - name
                - email
              additionalProperties: false
            status:
              type: string
              enum:
                - active
                - exhausted
                - expired
                - unavailable
            unit:
              type: string
              const: credit
            as_of:
              type: integer
              minimum: 0
              maximum: 9007199254740991
            allowance:
              type: object
              properties:
                total:
                  type: integer
                  minimum: 0
                  maximum: 9007199254740991
                used:
                  type: integer
                  minimum: 0
                  maximum: 9007199254740991
                remaining:
                  type: integer
                  minimum: 0
                  maximum: 9007199254740991
                reserved:
                  type: integer
                  minimum: 0
                  maximum: 9007199254740991
                expires_at:
                  anyOf:
                    - type: integer
                      minimum: 0
                      maximum: 9007199254740991
                    - type: 'null'
              required:
                - total
                - used
                - remaining
                - expires_at
              additionalProperties: false
            grants:
              maxItems: 20
              type: array
              items:
                anyOf:
                  - type: object
                    properties:
                      source:
                        type: string
                        enum:
                          - free
                          - subscription
                          - topup
                          - allowance
                      used:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      remaining:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      period_start:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      expires_at:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      profiles:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                    required:
                      - source
                      - used
                      - remaining
                      - period_start
                      - expires_at
                      - profiles
                    additionalProperties: false
                  - type: object
                    properties:
                      source:
                        type: string
                        enum:
                          - free
                          - subscription
                          - topup
                          - allowance
                      used:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      remaining:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      period_start:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      expires_at:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      unit:
                        type: string
                        const: credit
                      credits:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      reserved:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      profiles:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                    required:
                      - source
                      - used
                      - remaining
                      - period_start
                      - expires_at
                      - unit
                      - credits
                      - reserved
                    additionalProperties: false
            grants_truncated:
              type: boolean
            dashboard_url:
              type: string
              enum:
                - https://app.datalayer.so/#usage
                - https://staging.datalayer.so/#usage
          required:
            - status
            - as_of
            - allowance
            - grants
            - grants_truncated
          additionalProperties: false
        meta:
          type: object
          properties:
            retrieved_at:
              type: string
            billing_status:
              type: string
              const: account_included
            profiles_used:
              type: number
              const: 0
            credits_used:
              type: number
              const: 0
          required:
            - retrieved_at
            - billing_status
            - profiles_used
          additionalProperties: false
      required:
        - data
        - meta
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Datalayer API key
      description: >-
        Send Authorization: Bearer dl_live_<64 lowercase hexadecimal
        characters>. Signed-in users can create account-scoped, revocable keys
        in the Datalayer dashboard. A key does not grant credits. Dashboard
        session cookies are not API credentials.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.