> ## 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.

# Find job postings

> Cross-company indexed job postings from the last 1 to 90 days (default 30), through now, so a future job_posted_date is excluded. Country names and aliases are translated to ISO 3166-1 alpha-2 codes; existing codes pass through. Seniority, employment type, and function words are translated to the indexed labels described on those fields; unknown values pass through. Function boosts labeled matches instead of excluding recent unlabeled postings. With a query, unlabeled postings that match the query still appear. Without a query, the translated function label is also matched against the job title. Industry and company-name filters match indexed labels case-insensitively after whitespace is trimmed. Filters also include title/keywords, location text, and one optional company. Results are grouped by employer for this page and ordered newest posted date first, with a function match breaking a posted-date tie. The jobs-index company ID is a different namespace from the company profile ID. A page with at least one posting costs 1 credit; an empty successful page and failures cost zero. Identical searches repeat free for 24 hours. Indexed postings are not confirmed hires.

The assistant tool is `find_job_postings`. Search indexed job postings across companies. Provide at least one of `query`,
`function`, `seniority`, `employment_type`, `country`, `location`, `industry`,
`company_id` or `company`. `company_id` and `company` cannot be sent together.
`posted_within_days` defaults to 30 and cannot exceed 90. The window ends at
now: `job_posted_date` must be from now minus that many days through now, so a
future posted date, including a timestamp later today, is excluded.

Results on this page are grouped by employer and ordered newest posted date first. Each posting includes title,
location, seniority, posted date, source URL, a shortened plain-text description,
salary when present, function labels, employment type, close date and status,
source domain, and first-seen and updated dates. A company can continue on the
next page. Pages contain at most 25 postings, with offset at most 1000.
`result_scope.scope` is `indexed`. `mode` remains `provider_index`. `indexed_total`
matches `provider_total`.

`description` is the indexed posting text with HTML removed, whitespace
collapsed, and the text cut at 500 characters. `description_truncated` is true
when that cut happened. `salary` is present only when an amount, currency, or
pay unit was stored (`HOUR`, `DAY`, `WEEK`, `MONTH`, `YEAR`, or `ONCE`). An
empty salary object is returned as null. `functions` are the indexed function
labels. `employment_type` is the indexed employment type.

`closed_at` is the indexed close date, including a date still in the future.
`status` is `open` when that date is still ahead, `closed` when it has passed,
and null when no close date was stored. A missing close date is not treated as
open. `source_domain` is the hostname of the indexed posting URL, without a
leading `www`. `first_seen_at` is when the posting was first indexed.
`updated_at` is when the indexed posting was last updated. The page
`source_updated_at` is the newest valid `updated_at` on
this page. Unknown or future source dates stay null. Retrieval time is not
source freshness.

`company_id` on a group is the company profile ID only when the request filtered
by `company_id` and that profile was resolved through its LinkedIn organization
ID. The jobs-index company ID is a different namespace and is not returned.
Matching is case-insensitive. Surrounding and repeated whitespace is ignored.
Unknown values are sent unchanged.

Country accepts an English name, a common alias, or an ISO 3166-1 alpha-2 code.
`Canada` maps to `CA`. `United States` and `USA` map to `US`. `UK`,
`United Kingdom`, `Britain`, and `Great Britain` map to `GB`. Other English
country names map to their ISO code. An existing 2-letter code passes through,
including `CA`, `US`, and `GB`.

Seniority accepts an indexed label or a plain word:

| Input | Indexed label |
| - | - |
| intern, internship | Internship |
| entry, entry level, entry-level, junior | Entry-level |
| associate | Associate |
| mid, mid-level, senior, lead, mid-senior, mid-senior level | Mid-Senior level |
| director | Director |
| executive | Executive |
| not applicable | Not Applicable |

Employment type accepts `Full-time`, `Part-time`, `Contract`, `Temporary`,
`Internship`, `Volunteer`, or `Other`. Spacing and hyphens are ignored, so
`full time` and `fulltime` match `Full-time`. `contractor` matches `Contract`,
`temp` matches `Temporary`, and `intern` matches `Internship`.

Function accepts one indexed label: Accounting, Administrative, Advertising,
Analyst, Art / Creative, Business Development, Consulting, Customer Service,
Design, Distribution, Education, Engineering, Finance, General Business,
HealthCare Provider, Human Resources, Information Technology, Legal,
Management, Manufacturing, Marketing, Other, Product Management, Production,
Project Management, Public Relations, Purchasing, QualityAssurance, Research,
Sales, Science, Strategy / Planning, Supply Chain, Training, or
Writing / Editing. Spacing, hyphens, and slashes are ignored, so
`Quality Assurance` matches `QualityAssurance` and `Art/Creative` matches
`Art / Creative`. `healthcare` matches `HealthCare Provider`. Abbreviations
`IT`, `HR`, `QA`, and `PR` are accepted.

Function labels are filled in after the posting is indexed, so a
function boosts labeled matches instead of hiding recent unlabeled postings.
When `query` is present, an unlabeled posting that matches the query still
appears. When no query is present, the translated function label is also
matched against the job title, so an unlabeled recent posting whose title
contains that label still appears. Newest posted date stays first. A function
match sorts ahead of another posting with the same posted date.

Industry and company-name filters match indexed labels directly. Location is
a text match.

A successful page that returns at least one posting costs 1 credit. A successful
page with zero postings costs zero. Failures cost zero and are not evidence of
no postings. The identical search repeats free within 24 hours. `dry_run` and
`max_credits` apply. Indexed postings are not confirmed open roles or hires. A
timeout is not an empty market.


## OpenAPI

````yaml POST /v1/jobs/postings
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/jobs/postings:
    post:
      summary: find job postings
      description: >-
        Cross-company indexed job postings from the last 1 to 90 days (default
        30), through now, so a future job_posted_date is excluded. Country names
        and aliases are translated to ISO 3166-1 alpha-2 codes; existing codes
        pass through. Seniority, employment type, and function words are
        translated to the indexed labels described on those fields; unknown
        values pass through. Function boosts labeled matches instead of
        excluding recent unlabeled postings. With a query, unlabeled postings
        that match the query still appear. Without a query, the translated
        function label is also matched against the job title. Industry and
        company-name filters match indexed labels case-insensitively after
        whitespace is trimmed. Filters also include title/keywords, location
        text, and one optional company. Results are grouped by employer for this
        page and ordered newest posted date first, with a function match
        breaking a posted-date tie. The jobs-index company ID is a different
        namespace from the company profile ID. A page with at least one posting
        costs 1 credit; an empty successful page and failures cost zero.
        Identical searches repeat free for 24 hours. Indexed postings are not
        confirmed hires.
      operationId: find_job_postings
      parameters:
        - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/search_jobsInput'
      responses:
        '200':
          description: A settled result or a maximum estimate with no data lookup.
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    required:
                      - data
                      - meta
                    properties:
                      data:
                        $ref: '#/components/schemas/search_jobsData'
                      meta:
                        $ref: '#/components/schemas/UsageMetadata'
                    additionalProperties: false
                  - type: object
                    required:
                      - data
                      - meta
                    properties:
                      data:
                        $ref: '#/components/schemas/CreditEstimate'
                      meta:
                        $ref: '#/components/schemas/UsageMetadata'
                    additionalProperties: false
        '400':
          description: Invalid input or idempotency key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized, disconnected or revoked credential
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: No active allowance, credit budget or available credits
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: No matching identity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: >-
            Ambiguous/mismatched identity, changed/expired key or request in
            progress
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '413':
          description: Request exceeds 16KB
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: 'Account rate limit: 60/minute'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '502':
          description: Lookup or normalized contract failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Unavailable, cancelled or settlement interrupted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '504':
          description: Lookup or search timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  parameters:
    IdempotencyKey:
      name: Idempotency-Key
      in: header
      required: false
      description: >-
        Recommended for every paid operation. Account-scoped and bound to
        normalized operation/input. Retry exactly the same key after transport
        loss: a committed credit result is replayed from persisted normalized
        bytes without a data lookup or another debit. Changed input, key expiry
        or paid-anchor expiry returns 409. In-flight requests return
        request_in_progress. Network delivery and D1 commit are not atomic. If
        omitted a request ID is created.
      schema:
        type: string
        pattern: ^[A-Za-z0-9_-]{1,128}$
        minLength: 1
        maxLength: 128
  schemas:
    search_jobsInput:
      type: object
      properties:
        query:
          type: string
          minLength: 1
          maxLength: 200
        function:
          type: string
          minLength: 1
          maxLength: 200
          description: >-
            Indexed job function: Accounting, Administrative, Advertising,
            Analyst, Art / Creative, Business Development, Consulting, Customer
            Service, Design, Distribution, Education, Engineering, Finance,
            General Business, HealthCare Provider, Human Resources, Information
            Technology, Legal, Management, Manufacturing, Marketing, Other,
            Product Management, Production, Project Management, Public
            Relations, Purchasing, QualityAssurance, Research, Sales, Science,
            Strategy / Planning, Supply Chain, Training, Writing / Editing.
            Spacing, hyphens, and slashes are ignored, so Quality Assurance
            matches QualityAssurance, healthcare and Health Care Provider match
            HealthCare Provider, and Art/Creative matches Art / Creative.
            Abbreviations IT, HR, QA, and PR are accepted. Matching is
            case-insensitive. Unknown values pass through unchanged. Function
            labels are filled in after the posting is indexed, so this boosts
            labeled matches instead of excluding recent unlabeled postings. When
            a query is present, unlabeled postings that match the query still
            appear. When no query is present, the translated label is also
            matched against the job title. Newest posted date stays first, and a
            function match breaks a tie.
        seniority:
          type: string
          minLength: 1
          maxLength: 200
          description: >-
            Indexed seniority or a plain word. intern maps to Internship. entry
            and junior map to Entry-level. mid, senior, and lead map to
            Mid-Senior level. director maps to Director. executive maps to
            Executive. Indexed labels also accepted: Internship, Entry-level,
            Associate, Mid-Senior level, Director, Executive, Not Applicable.
            Matching is case-insensitive. Unknown values pass through unchanged.
        employment_type:
          type: string
          minLength: 1
          maxLength: 200
          description: >-
            Indexed employment type: Full-time, Part-time, Contract, Temporary,
            Internship, Volunteer, or Other. Spacing and hyphens are ignored, so
            full time and fulltime match Full-time. contractor matches Contract,
            temp matches Temporary, and intern matches Internship. Matching is
            case-insensitive. Unknown values pass through unchanged.
        country:
          type: string
          minLength: 1
          maxLength: 200
          description: >-
            English country name, common alias, or ISO 3166-1 alpha-2 code.
            Canada maps to CA. United States and USA map to US. UK, United
            Kingdom, Britain, and Great Britain map to GB. Other English country
            names map to their ISO code. Existing 2-letter codes pass through.
            Matching is case-insensitive. Unknown values pass through unchanged.
        location:
          type: string
          minLength: 1
          maxLength: 200
        industry:
          type: string
          minLength: 1
          maxLength: 200
        posted_within_days:
          default: 30
          description: >-
            Inclusive posted window ending now. job_posted_date must fall from
            now minus this many days through now, so a future posted date is
            excluded.
          type: integer
          minimum: 1
          maximum: 90
        company_id:
          type: string
          pattern: ^[1-9][0-9]{0,19}$
        company:
          type: string
          minLength: 1
          maxLength: 200
        limit:
          default: 10
          description: >-
            Advanced: how many matches to return on this page, from 1 to 25.
            Defaults to 10.
          type: integer
          minimum: 1
          maximum: 25
        offset:
          default: 0
          description: >-
            Advanced: how many matches to skip before this page, from 0 to 1000.
            Defaults to 0.
          type: integer
          minimum: 0
          maximum: 1000
        max_credits:
          description: >-
            Advanced: highest number of credits this call may spend. The call is
            refused before any lookup when the estimate is higher.
          type: integer
          minimum: 0
          maximum: 3
        dry_run:
          description: >-
            Advanced: return the maximum credit estimate without looking up
            data.
          type: boolean
      additionalProperties: false
      anyOf:
        - required:
            - query
        - required:
            - function
        - required:
            - seniority
        - required:
            - employment_type
        - required:
            - country
        - required:
            - location
        - required:
            - industry
        - required:
            - company_id
        - required:
            - company
    search_jobsData:
      type: object
      properties:
        offset:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        limit:
          type: integer
          minimum: 1
          maximum: 25
        next_offset:
          anyOf:
            - type: integer
              minimum: -9007199254740991
              maximum: 1000
            - type: 'null'
        result_scope:
          type: object
          properties:
            mode:
              type: string
              enum:
                - bounded_shortlist
                - provider_keyword_index
                - provider_index
              deprecated: true
              description: >-
                Deprecated. Read scope. provider_index is indexed and
                provider_keyword_index is keyword_index.
            scope:
              description: >-
                Result scope. indexed is the same outcome as mode
                provider_index. keyword_index is the same outcome as
                provider_keyword_index. bounded_shortlist is unchanged.
              type: string
              enum:
                - bounded_shortlist
                - keyword_index
                - indexed
            evaluated:
              type: integer
              minimum: 0
              maximum: 25
            exhaustive:
              type: boolean
              const: false
            filters_applied_to:
              type: string
            provider_total:
              deprecated: true
              description: Deprecated. Read indexed_total. The value is the same.
              anyOf:
                - type: integer
                  minimum: 0
                  maximum: 9007199254740991
                - type: 'null'
            indexed_total:
              description: >-
                Indexed total for this result scope. Prefer this field. It
                matches provider_total.
              anyOf:
                - type: integer
                  minimum: 0
                  maximum: 9007199254740991
                - type: 'null'
          required:
            - mode
            - evaluated
            - exhaustive
          additionalProperties: false
        coverage_note:
          type: string
          maxLength: 2000
        total:
          anyOf:
            - type: object
              properties:
                value:
                  anyOf:
                    - type: integer
                      minimum: 0
                      maximum: 9007199254740991
                    - type: 'null'
                relation:
                  type: string
                  enum:
                    - eq
                    - gte
              required:
                - value
                - relation
              additionalProperties: false
            - type: 'null'
        truncated:
          type: boolean
        posted_within_days:
          type: integer
          minimum: 1
          maximum: 90
        retrieved_at:
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
        source_updated_at:
          anyOf:
            - type: string
              maxLength: 10000
            - type: 'null'
        companies:
          maxItems: 25
          type: array
          items:
            type: object
            properties:
              company_id:
                anyOf:
                  - type: string
                    pattern: ^[1-9][0-9]{0,19}$
                  - type: 'null'
              company_name:
                anyOf:
                  - type: string
                    maxLength: 10000
                  - type: 'null'
              linkedin_org_id:
                anyOf:
                  - type: string
                    pattern: ^[1-9][0-9]{0,19}$
                  - type: 'null'
              match_basis:
                type: string
                enum:
                  - company_id
                  - linkedin_reference
                  - exact_name_shortlist
              postings:
                maxItems: 25
                type: array
                items:
                  type: object
                  properties:
                    title:
                      anyOf:
                        - type: string
                          maxLength: 10000
                        - type: 'null'
                    location:
                      anyOf:
                        - type: string
                          maxLength: 10000
                        - type: 'null'
                    seniority:
                      anyOf:
                        - type: string
                          maxLength: 10000
                        - type: 'null'
                    posted_at:
                      anyOf:
                        - type: string
                          maxLength: 10000
                        - type: 'null'
                    source_url:
                      anyOf:
                        - type: string
                          maxLength: 2000
                          format: uri
                        - type: 'null'
                    description:
                      anyOf:
                        - type: string
                          maxLength: 500
                        - type: 'null'
                    description_truncated:
                      type: boolean
                    salary:
                      anyOf:
                        - type: object
                          properties:
                            min:
                              anyOf:
                                - type: number
                                  minimum: 0
                                - type: 'null'
                            max:
                              anyOf:
                                - type: number
                                  minimum: 0
                                - type: 'null'
                            currency:
                              anyOf:
                                - type: string
                                  pattern: ^[A-Z]{3}$
                                - type: 'null'
                            unit:
                              anyOf:
                                - type: string
                                  enum:
                                    - HOUR
                                    - DAY
                                    - WEEK
                                    - MONTH
                                    - YEAR
                                    - ONCE
                                - type: 'null'
                          required:
                            - min
                            - max
                            - currency
                            - unit
                          additionalProperties: false
                        - type: 'null'
                    functions:
                      maxItems: 12
                      type: array
                      items:
                        type: string
                        minLength: 1
                        maxLength: 200
                    employment_type:
                      anyOf:
                        - type: string
                          maxLength: 10000
                        - type: 'null'
                    closed_at:
                      anyOf:
                        - type: string
                          maxLength: 10000
                        - type: 'null'
                    status:
                      anyOf:
                        - type: string
                          enum:
                            - open
                            - closed
                        - type: 'null'
                    source_domain:
                      anyOf:
                        - type: string
                          pattern: >-
                            ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,63}$
                        - type: 'null'
                    first_seen_at:
                      anyOf:
                        - type: string
                          maxLength: 10000
                        - type: 'null'
                    updated_at:
                      anyOf:
                        - type: string
                          maxLength: 10000
                        - type: 'null'
                  required:
                    - title
                    - location
                    - seniority
                    - posted_at
                    - source_url
                    - description
                    - description_truncated
                    - salary
                    - functions
                    - employment_type
                    - closed_at
                    - status
                    - source_domain
                    - first_seen_at
                    - updated_at
                  additionalProperties: false
              postings_in_page:
                type: integer
                minimum: 0
                maximum: 25
            required:
              - company_id
              - company_name
              - linkedin_org_id
              - match_basis
              - postings
              - postings_in_page
            additionalProperties: false
      required:
        - offset
        - limit
        - next_offset
        - result_scope
        - coverage_note
        - total
        - truncated
        - posted_within_days
        - retrieved_at
        - source_updated_at
        - companies
      additionalProperties: false
    UsageMetadata:
      type: object
      required:
        - retrieved_at
        - billing_status
        - profiles_used
      properties:
        request_id:
          type: string
        contract_version:
          const: '2026-10-19'
        credit_version:
          type: string
          enum:
            - datalayer_credits_v1
            - datalayer_credits_v2
        retrieved_at:
          type: string
          format: date-time
        upstream_requests:
          type: integer
          minimum: 0
          maximum: 8
          deprecated: true
          description: Deprecated. Read lookup_requests. The count is the same.
        lookup_requests:
          type: integer
          minimum: 0
          maximum: 8
          description: >-
            Lookup calls for this response. Prefer this field. It matches
            upstream_requests. Zero on replay.
        billing_status:
          type: string
          enum:
            - credits_settled
            - estimate_included
            - search_included
            - profile_deducted
            - repeat_included
            - idempotent_replay
        credits_used:
          type: integer
          minimum: 0
          maximum: 3
          description: >-
            Credits newly deducted by this invocation. Zero on replay. Not the
            remaining balance.
        profiles_used:
          type: integer
          minimum: 0
          maximum: 1
          deprecated: true
          description: >-
            Deprecated. Credit responses report credits_used and set this to 0.
            Older clients may still read it.
        receipt:
          $ref: '#/components/schemas/CreditReceipt'
        replayed:
          type: boolean
      additionalProperties: false
    CreditEstimate:
      type: object
      properties:
        contract_version:
          type: string
          const: '2026-10-19'
        credit_version:
          type: string
          enum:
            - datalayer_credits_v1
            - datalayer_credits_v2
        maximum_credits:
          type: integer
          minimum: 0
          maximum: 100
        minimum_credits:
          type: number
          const: 0
        provider_calls:
          type: number
          const: 0
          deprecated: true
          description: Deprecated. Read lookup_calls. The value is the same.
        lookup_calls:
          description: >-
            Lookup calls in this estimate. Prefer this field. It matches
            provider_calls and is 0 because an estimate makes no lookup.
          type: number
          const: 0
        repeat_window_hours:
          type: number
          const: 24
        note:
          type: string
      required:
        - contract_version
        - credit_version
        - maximum_credits
        - minimum_credits
        - provider_calls
        - repeat_window_hours
        - note
      additionalProperties: false
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
          additionalProperties: false
      additionalProperties: false
    CreditReceipt:
      type: object
      properties:
        version:
          type: string
          enum:
            - datalayer_credits_v1
            - datalayer_credits_v2
        request_id:
          type: string
          minLength: 1
          maxLength: 128
        reserved:
          type: integer
          minimum: 0
          maximum: 100
        settled:
          type: integer
          minimum: 0
          maximum: 100
        released:
          type: integer
          minimum: 0
          maximum: 100
        items:
          maxItems: 100
          type: array
          items:
            type: object
            properties:
              kind:
                type: string
                enum:
                  - company
                  - person
                  - work_email
                  - validation
                  - jobs_search
                  - tech_stack
                  - tech_sites
                  - segment_export
                  - company_search
                  - people_search
              reference:
                type: string
                maxLength: 254
              credits:
                anyOf:
                  - type: number
                    const: 0
                  - type: number
                    const: 1
                  - type: number
                    const: 2
              repeat:
                type: boolean
            required:
              - kind
              - reference
              - credits
              - repeat
            additionalProperties: false
      required:
        - version
        - request_id
        - reserved
        - settled
        - released
        - items
      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.