API Documentation

API documentation

Robinsonlisten lookups via REST API

🚀 Get Started in Minutes

Quick start: Get your API key on the homepage (100 free lookups) or see pricing for unlimited lookups.

API Endpoints

Simple, RESTful endpoints for Robinson list lookups and address normalization

Robinson List Identification

GET https://robinsonlistenapi.dk/api/v1/identifications

âś“ Single person lookup via query parameters

POST https://robinsonlistenapi.dk/api/v1/identifications Recommended

✓ Batch lookup (up to 1,000 people per request) – Best for high volume

Address Normalization FREE

Validate and normalize Danish addresses using official DAWA data

POST https://robinsonlistenapi.dk/api/v1/address/normalize

âś“ Normalize and validate a single Danish address

POST https://robinsonlistenapi.dk/api/v1/address/normalize/batch

âś“ Batch address normalization (up to 100 addresses per request)

Authentication

Include your API key in the request body:

{
  "api_key": "your_api_key_here",
  "search": [...]
}

Request format

Send an array of people you want to check. Each person MUST include an address (with zip code). First name and last name are optional but highly recommended for accurate matching.

Parameter Type Required Description
first_name string Optional First name (optional but recommended)
last_name string Optional Last name (optional but recommended)
address string Optional Address including zip code, e.g. "Vesterbrogade 1, 1620" (REQUIRED)
phone_number string Optional Phone number (Danish format)
kvhx string Optional Official Danish address code (KVHX)
query string Optional General search query (tries both name and address)
id string/number Optional Your internal ID (returned in response for tracking)

Note: Provide at least one search parameter. The API will attempt to match on name, address, phone number, or KVHX code.

Example

Response format

Response fields

Field Description
robinsonlisten "1" = on list, "0" = not on list
robinson_matched_on Array of fields that matched (e.g., ["first_name", "last_name", "address"]). Empty array if no match.
phone_lookup_data Only for phone lookups - data about the number owner

Example interpretation

If the response shows:

  
    [
      {
        "query": "Marcus Jensen",
        "result": {
          "robinsonlisten": "1",
          "robinson_matched_on": "first_name, last_name",
          "robinson_match_attempts": "first_name, last_name, address"
        }
      }
    ]
  

It means: The search for "Marcus Jensen" returned a match. The person is on Robinsonlisten and was matched on name (first_name, last_name).

Address Normalization API

The Address Normalization API validates and normalizes Danish addresses using official DAWA (Danmarks Adressers Web API) data.

Free to use: Address normalization requests are tracked for monitoring but do NOT count toward your API usage limits or billing.

Single Address Normalization

POST https://robinsonlistenapi.dk/api/v1/address/normalize

Request Parameters

Parameter Type Required Description
api_key string Yes Your API key
address string Yes The Danish address to normalize

Example Request

{
  "api_key": "your_api_key_here",
  "address": "Vesterbrogade 1, 1620"
}

Response Format

{
  "address": "Vesterbrogade 1, 1620",
  "success": true,
  "match_quality": "A",
  "normalized_address": "Vesterbrogade 1, 1., 1620 København V",
  "kvhx": "01010101__1__1",
  "components": {
    "municipality_code": "0101",
    "road_code": "0101",
    "house_number": "1",
    "floor": "1",
    "door": null,
    "postal_code": "1620",
    "city": "København V"
  },
  "coordinates": {
    "lat": 55.674557,
    "lng": 12.561615
  }
}

Batch Address Normalization

POST https://robinsonlistenapi.dk/api/v1/address/normalize/batch

Maximum 100 addresses per request

Example Request

{
  "api_key": "your_api_key_here",
  "addresses": [
    "Vesterbrogade 1, 1620",
    "Nørrebrogade 20, 2200",
    "Amagerbrogade 150, 2300"
  ]
}

Response Fields

Field Description
success Whether the address was successfully normalized
match_quality A = perfect match, B = good match, C = uncertain match
normalized_address The official normalized address format
kvhx Official Danish address code (Kommune-Vej-Husnummer-Etage-Dør)
components Structured address components (municipality, road, house number, floor, door, postal code, city)
coordinates GPS coordinates (latitude and longitude)

Batch lookups

Send multiple people in the same request to optimize throughput.

Tip: For large datasets (>1000 people), contact us for access to our dedicated batch endpoint with higher limits.

Need help?

Pricing & Plans

See our pricing or get access to unlimited lookups

Learn More →

Contact Support

Have questions or need technical assistance?

Marcus Wilstrup

Need custom development or API integration help?

Work directly with Marcus Wilstrup, the creator of Robinsonlisten API. Get expert help building scalable web applications, integrating complex APIs, and modernizing your tech stack.

Ruby on Rails • API Development • System Integration • Technical Consulting