Treffer Logo treffer Docs

B2B Data Enrichment API for the German market

Treffer is B2B enrichment infrastructure for sales, marketing, RevOps, developers, and AI agents. Credits are charged only when we find a record.

Base URL

https://api.treffer.io/v1

Every request carries your key in the X-API-Key header. Lookups are POST with a JSON body, account reads are GET. See Authentication.

Endpoints

Shared response fields

Every lookup returns these three fields alongside its own data fields.

Field Type Meaning
found boolean Whether we have found a record.
credits_consumed integer What this call costs you. Always 0 when found is false.
message string Human readable summary of the result. The wording can change, so do not parse or depend on it.

Response shape

Every field is always in the response, hit or miss. A value we do not have is null, a list with no items is empty, and nested groups like register are always there with all their fields. You can map any path, like register.status, without checking whether a key exists.

Misses and billing

A miss is not an error

Not finding a record is a normal answer: HTTP 200 with found false.

You pay for hits only

Misses, validation errors, rate limits and outages all cost nothing. See Credits.

OpenAPI

The machine readable schema is at https://api.treffer.io/v1/openapi.json. Import it into Postman or Insomnia, or hand it to an AI coding assistant to generate integration code.

Privacy Policy Terms of Service Imprint