DataMerge

DataMerge API

DataMerge API as documented publicly: 15 operations. Contract generated from the documentation by API Evangelist (2026-11-05); not the provider's own document.

Documentation GitHub OpenAPI

Operations 15

POST /v1/company/enrich POST /v1/company/enrich #

GET /v1/company/enrich/{enrichid}/status GET /v1/company/enrich/abc123/status #

GET /v1/company/get GET /v1/company/get #

GET /v1/company/hierarchy GET /v1/company/hierarchy #

POST /v1/contact/enrich POST /v1/contact/enrich #

GET /v1/contact/get GET /v1/contact/get #

POST /v1/contact/search POST /v1/contact/search #

GET /v1/contact/search/{jobid}/status GET /v1/contact/search/{jobId}/status #

GET /v1/credits/balance GET /v1/credits/balance #

GET /v1/lists GET /v1/lists #

POST /v1/lists POST /v1/lists #

DELETE /v1/lists/company/target-accounts DELETE /v1/lists/company/target-accounts #

GET /v1/lists/company/target-accounts GET /v1/lists/company/target-accounts #

GET /v1/lists/company/target-accounts/{recordId} Remove an item from a list #

DELETE /v1/lists/company/target-accounts/{recordid} DELETE /v1/lists/company/target-accounts/{recordId} #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/datamerge-ai/openapi/_ae-authored/datamerge-ai-openapi-generated.yml

Schemas & Data

📊

JSONSchema

https://artifacts.apis.io/datamerge-ai/json-schema/datamerge-ai-post-v1-contact-search-request-schema.json

📊

JSONSchema

https://artifacts.apis.io/datamerge-ai/json-schema/datamerge-ai-delete-v1-lists-company-target-accounts-recordid-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/datamerge-ai/json-schema/datamerge-ai-delete-v1-lists-company-target-accounts-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/datamerge-ai/json-schema/datamerge-ai-get-v1-credits-balance-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/datamerge-ai/json-schema/datamerge-ai-get-v1-lists-company-target-accounts-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/datamerge-ai/json-schema/datamerge-ai-get-v1-lists-response-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/datamerge-ai:datamerge-ai-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.1.0
info:
  title: DataMerge API
  version: '2026-11-05'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-05: 15 operation(s) read from 11 public documentation page(s) (each
    operation names its page in x-source). This is not the provider''s published contract; DataMerge has published no machine-readable contract
    that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 15
    documentation: 0
    pages-with-code: 10
    pages-read: 11
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-05'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://www.datamerge.ai/developers
  - https://www.datamerge.ai/de/developers
  - https://www.datamerge.ai/es/developers
  - https://www.datamerge.ai/fr/developers
  - https://www.datamerge.ai/pl/developers
  - https://www.datamerge.ai/pt/developers
  - https://www.datamerge.ai/docs/quickstart.md
  - https://www.datamerge.ai/use-cases/sales
  - https://www.datamerge.ai/use-cases/ai-agents
  - https://www.datamerge.ai/integrations
  - https://www.datamerge.ai/SKILL.md
servers:
- url: https://api.datamerge.ai
paths:
  /v1/company/enrich:
    post:
      operationId: post_v1_company_enrich
      tags:
      - Company
      summary: POST /v1/company/enrich
      x-source: https://www.datamerge.ai/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1CompanyEnrichRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -X POST https://api.datamerge.ai/v1/company/enrich  -H "Authorization: Token $KEY"  -H "Content-Type: application/json"  -d
          ''{"domains": ["stripe.com"]}'''
  /v1/company/enrich/{enrichid}/status:
    get:
      operationId: get_v1_company_enrich_enrichid_status
      tags:
      - Company
      summary: GET /v1/company/enrich/abc123/status
      x-source: https://www.datamerge.ai/developers
      parameters:
      - name: enrichid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1CompanyEnrichEnrichidStatusResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl https://api.datamerge.ai/v1/company/enrich/abc123/status  -H "Authorization: Token $KEY"'
        collapsed_from: 2 example path(s) differing only at enrichId
  /v1/company/get:
    get:
      operationId: get_v1_company_get
      tags:
      - Company
      summary: GET /v1/company/get
      x-source: https://www.datamerge.ai/docs/quickstart.md
      parameters:
      - name: record_id
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1CompanyGetResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl "https://api.datamerge.ai/v1/company/get?record_id=uuid1"  -H "Authorization: Token $DATAMERGE_API_KEY"

          ```'
  /v1/company/hierarchy:
    get:
      operationId: get_v1_company_hierarchy
      tags:
      - Company
      summary: GET /v1/company/hierarchy
      x-source: https://www.datamerge.ai/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl "https://api.datamerge.ai/v1/company/hierarchy ?datamerge_id=DM001283124635&include_names=true"  -H "Authorization: Token
          $KEY"'
  /v1/contact/enrich:
    post:
      operationId: post_v1_contact_enrich
      tags:
      - Contact
      summary: POST /v1/contact/enrich
      x-source: https://www.datamerge.ai/SKILL.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1ContactEnrichRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1ContactEnrichResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.datamerge.ai/v1/contact/enrich  -H \"Authorization: Token $DATAMERGE_API_KEY\"  -H \"Content-Type:\
          \ application/json\"  -d '{\n    \"contacts\": [\n      {\"linkedin_url\": \"https://www.linkedin.com/in/johndoe\"},\n      {\"firstname\"\
          : \"Jane\", \"lastname\": \"Smith\", \"domain\": \"stripe.com\"}\n    ],\n    \"enrich_fields\": [\"contact.emails\", \"contact.phones\"\
          ]\n  }'\n```"
  /v1/contact/get:
    get:
      operationId: get_v1_contact_get
      tags:
      - Contact
      summary: GET /v1/contact/get
      x-source: https://www.datamerge.ai/docs/quickstart.md
      parameters:
      - name: record_id
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl "https://api.datamerge.ai/v1/contact/get?record_id=RECORD_ID"  -H "Authorization: Token $DATAMERGE_API_KEY"

          ```'
  /v1/contact/search:
    post:
      operationId: post_v1_contact_search
      tags:
      - Contact
      summary: POST /v1/contact/search
      x-source: https://www.datamerge.ai/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1ContactSearchRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.datamerge.ai/v1/contact/search  -H \"Authorization: Token $KEY\"  -d '{\n \"domains\": [\"stripe.com\"\
          ],\n \"filters\": {\"job_titles_include\": [\"CEO\",\"CTO\"]},\n \"enrich_fields\": [\"contact.emails\"]\n }' 1 credit per email · 4\
          \ credits per mobile\n How the API Works: Async Jobs \nAll enrichment endpoints are asynchronous. Every request returns a job_id immediately.\
          \ Poll the status endpoint"
  /v1/contact/search/{jobid}/status:
    get:
      operationId: get_v1_contact_search_jobid_status
      tags:
      - Contact
      summary: GET /v1/contact/search/{jobId}/status
      x-source: https://www.datamerge.ai/docs/quickstart.md
      parameters:
      - name: jobid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1ContactSearchJobidStatusResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl https://api.datamerge.ai/v1/contact/search/JOB_ID/status  -H "Authorization: Token $DATAMERGE_API_KEY"'
  /v1/credits/balance:
    get:
      operationId: get_v1_credits_balance
      tags:
      - Credits
      summary: GET /v1/credits/balance
      x-source: https://www.datamerge.ai/SKILL.md
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1CreditsBalanceResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl https://api.datamerge.ai/v1/credits/balance  -H "Authorization: Token $DATAMERGE_API_KEY"'
  /v1/lists:
    get:
      operationId: get_v1_lists
      tags:
      - Lists
      summary: GET /v1/lists
      x-source: https://www.datamerge.ai/SKILL.md
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1ListsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl https://api.datamerge.ai/v1/lists  -H "Authorization: Token $DATAMERGE_API_KEY"'
    post:
      operationId: post_v1_lists
      tags:
      - Lists
      summary: POST /v1/lists
      x-source: https://www.datamerge.ai/SKILL.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1ListsRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1ListsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -X POST https://api.datamerge.ai/v1/lists  -H "Authorization: Token $DATAMERGE_API_KEY"  -H "Content-Type: application/json"  -d
          ''{"name": "Target Accounts", "object_type": "company"}'''
  /v1/lists/company/target-accounts:
    delete:
      operationId: delete_v1_lists_company_target_accounts
      tags:
      - Lists
      summary: DELETE /v1/lists/company/target-accounts
      x-source: https://www.datamerge.ai/SKILL.md
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteV1ListsCompanyTargetAccountsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -X DELETE "https://api.datamerge.ai/v1/lists/company/target-accounts"  -H "Authorization: Token $DATAMERGE_API_KEY"

          ```'
    get:
      operationId: get_v1_lists_company_target_accounts
      tags:
      - Lists
      summary: GET /v1/lists/company/target-accounts
      x-source: https://www.datamerge.ai/SKILL.md
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1ListsCompanyTargetAccountsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl "https://api.datamerge.ai/v1/lists/company/target-accounts"  -H "Authorization: Token $DATAMERGE_API_KEY"'
  /v1/lists/company/target-accounts/{recordId}:
    get:
      operationId: get_v1_lists_company_target_accounts_recordId
      tags:
      - Lists
      summary: Remove an item from a list
      x-source: https://www.datamerge.ai/SKILL.md
      parameters:
      - name: recordId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/lists/company/target-accounts/{recordid}:
    delete:
      operationId: delete_v1_lists_company_target_accounts_recordid
      tags:
      - Lists
      summary: DELETE /v1/lists/company/target-accounts/{recordId}
      x-source: https://www.datamerge.ai/SKILL.md
      parameters:
      - name: recordid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteV1ListsCompanyTargetAccountsRecordidResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -X DELETE "https://api.datamerge.ai/v1/lists/company/target-accounts/RECORD_ID"  -H "Authorization: Token $DATAMERGE_API_KEY"'
components:
  schemas:
    PostV1CompanyEnrichRequest:
      type: object
      properties:
        domains:
          type: array
          items:
            type: string
    GetV1CompanyEnrichEnrichidStatusResponse:
      type: object
      properties:
        status:
          type: string
        record_ids:
          type: array
          items:
            type: string
    GetV1CompanyGetResponse:
      type: object
      properties:
        job_id:
          type: string
        status:
          type: string
    PostV1ContactEnrichRequest:
      type: object
      properties:
        contacts:
          type: array
          items:
            type: object
            properties:
              linkedin_url:
                type: string
        enrich_fields:
          type: array
          items:
            type: string
    PostV1ContactEnrichResponse:
      type: object
      properties:
        credits_balance:
          type: integer
        balances:
          type: object
          properties:
            one_off:
              type: integer
            recurring:
              type: integer
            rollover:
              type: integer
            total:
              type: integer
    PostV1ContactSearchRequest:
      type: object
      properties:
        domains:
          type: array
          items:
            type: string
        filters:
          type: object
          properties:
            job_titles_include:
              type: array
              items:
                type: string
        enrich_fields:
          type: array
          items:
            type: string
    GetV1ContactSearchJobidStatusResponse:
      type: object
      properties:
        status:
          type: string
        record_ids:
          type: array
          items: {}
    GetV1CreditsBalanceResponse:
      type: object
      properties:
        credits_balance:
          type: integer
        balances:
          type: object
          properties:
            one_off:
              type: integer
            recurring:
              type: integer
            rollover:
              type: integer
            total:
              type: integer
    GetV1ListsResponse:
      type: object
      properties:
        credits_balance:
          type: integer
        balances:
          type: object
          properties:
            one_off:
              type: integer
            recurring:
              type: integer
            rollover:
              type: integer
            total:
              type: integer
    PostV1ListsRequest:
      type: object
      properties:
        name:
          type: string
        object_type:
          type: string
    PostV1ListsResponse:
      type: object
      properties:
        credits_balance:
          type: integer
        balances:
          type: object
          properties:
            one_off:
              type: integer
            recurring:
              type: integer
            rollover:
              type: integer
            total:
              type: integer
    DeleteV1ListsCompanyTargetAccountsResponse:
      type: object
      properties:
        credits_balance:
          type: integer
        balances:
          type: object
          properties:
            one_off:
              type: integer
            recurring:
              type: integer
            rollover:
              type: integer
            total:
              type: integer
    GetV1ListsCompanyTargetAccountsResponse:
      type: object
      properties:
        credits_balance:
          type: integer
        balances:
          type: object
          properties:
            one_off:
              type: integer
            recurring:
              type: integer
            rollover:
              type: integer
            total:
              type: integer
    DeleteV1ListsCompanyTargetAccountsRecordidResponse:
      type: object
      properties:
        credits_balance:
          type: integer
        balances:
          type: object
          properties:
            one_off:
              type: integer
            recurring:
              type: integer
            rollover:
              type: integer
            total:
              type: integer
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: Authorization
security:
- apiKey: []
tags:
- name: Company
- name: Contact
- name: Credits
- name: Lists