UK B2B Contacts Your AI Agent Can Access Directly

Endpoint

Authentication: API key in the X-Api-Key header. The REST API uses API-key auth — distinct from the MCP server, which uses OAuth. Get a key at app.mydatahub.uk → System → API.

Query parameters

Response

200 OK with application/json:

{
  "orderId": "ORD-12345",
  "packId": "...",
  "suppressedKeyCount": 0,
  "alreadyExtracted": 0,
  "suppressionSessionId": "...",
  "pagingEnabled": true,
  "pageNumber": 1,
  "pageSize": 100,
  "packFormat": [
    {
      "displayOrder": 1,
      "fieldName": "FirstName",
      "displayName": "First Name",
      "mask": null
    }
    // ...one entry per field in the order's pack
  ],
  "selections": [
    {
      "totalRows": 12345,
      "returned_rows": 100,
      "has_more": true,
      "total_pages": 124,
      "rows": [
        // contact rows — fields per packFormat
      ]
    }
  ]
}

packFormat describes the fields available on each row (field name, display name, optional masking). Iterate selections[*].rows[] for the contact data; paginate by re-calling with the next pageNumber until has_more is false.

Status codes

• 200 OK — success. JSON body as above.
• 200 OK with body { Success: false, Message: "Invalid response payload." } — order recognised but payload empty. Treat as a soft error.
• 400 Bad Request — runtime exception (e.g. invalid OrderId shape).
• 403 Forbidden — missing or invalid X-Api-Key.

Example

curl -X POST \
  'https://app.mydatahub.uk/api/RunExtract?OrderId=ORD-12345&pageNumber=2&pageSize=3' \
  -H 'X-Api-Key: <your-api-key>'