Order lists and enrich records programmatically.

Endpoints

• POST/v1/counts

  Return an indicative record count for a set of filters before ordering.

• POST/v1/orders

  Create an order for a defined audience, field selection and quantity.

• GET/v1/orders/{id}

  Check order status and retrieve download links once the file is ready.

• POST/v1/enrich

  Submit company names or postcodes and receive matched fields.

• POST/v1/suppression

  Upload a suppression file to exclude your existing customers.

Access and limits

• Keys are issued per account and can be rotated at any time.
• Rate limit of 60 requests per minute; higher limits by arrangement.
• Counts are indicative. Billing is based on records actually delivered.
• Sandbox keys return representative data without creating a chargeable order.

Example request

curl https://api.listworks.co.uk/v1/counts \
  -H "Authorization: Bearer $LISTWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "industry": "Roofing contractors",
    "region": "North West England",
    "filters": { "website_status": "none", "telephone_present": true }
  }'

Response

{
  "count": 1840,
  "confidence": "indicative",
  "fields_available": ["company_name", "telephone", "town", "postcode"],
  "notes": "Final volume confirmed at fulfilment."
}

All requests are made over HTTPS. Keys must be kept server-side and never included in browser code.