4,8op Trustpilot 070-2400862
Developer docs

API Documentatie Basis 1.0

AuthenticatieOpmerkingenQuery APIInputReferentielijstenOutput

Authenticatie van deze API gaat middels een ApiKey header. Deze key is in de portal van Ad Hoc Data aan te maken. Mocht je deze key nog niet hebben, vraag deze dan op bij de opdrachtgever. Daarnaast moet bij een POST call de Content-Type header gevuld worden. Een GET call moet geen Content-Type hebben.

Verplichte header
  • ApiKey: {key}
Verplicht bij POST
  • Content-Type: application/json
  • Deze API verwacht en levert data uit in JSON formaat. Bij een 415, Unsupported Media Type status, check de Content-Type header. Meer informatie over RESTful API services.
  • JSON properties hieronder beschreven zijn case sensitive. Bij afwijken in casing kan het zijn dat de waarde niet wordt verwerkt.
  • Er geldt een limiet van 2 calls per seconde. Bij overschrijden van dit limit zal een 429, Too Many Requests geretourneerd worden.

POSThttps://api.adhocdata.nl/query/nl-basis/1.0

Voorbeeld telling

Input

Voor de exacte input data, zie input.

{
  "Action": "Count",
  "Conditions": [
    {
      "Field": "Postcode",
      "Type": "BETWEEN",
      "Value": "2514AA,2514AD"
    },
    {
      "Field": "Postcode",
      "Type": "!IN",
      "Value": "2514AB,2514AC"
    }
  ]
}

Output

 

{
  "Response": {
    "ResponseType": "count",
    "Data": [
      {
        "COUNT": 237
      }
    ]
  },
  "Result": "success",
  "DateRequest": "2026-01-01T12:00:00.000Z"
}

Voorbeeld exporteren data

Input

Voor de exacte input data, zie input.

{
  "Action": "Get",
  "Take": 1000,
  "Skip": 0,
  "OrderBy": {
    "FANAAM": "ASC"
  },
  "Fields": [
    "AHDNR",
    "SBIHOOFDACT",
    "DOSSIERNR",
    "SUBDOSSIERNR",
    "VESTIGINGSNR",
    "FANAAM",
    "STRAAT",
    "HUISNR",
    "HUISNRTOEV",
    "POSTCODE",
    "WOONPLAATS",
    "OPRICHTINGSDATUM",
    "MUTATIEDATUM"
  ],
  "Conditions": [
    {
      "Field": "Postcode",
      "Type": "BETWEEN",
      "Value": "2514AA,2514AD"
    },
    {
      "Field": "Postcode",
      "Type": "!IN",
      "Value": "2514AB,2514AC"
    }
  ]
}

Output

Voor de exacte output data, zie output.

{
  "response": {
    "responseType": "preview",
    "data": [
      {
        "AHDNR": "ADH00000ADAZEFF",
        "DOSSIERNR": "28077834",
        "SUBDOSSIERNR": "0000",
        "VESTIGINGSNR": "000017817110",
        "FANAAM": "Ad Hoc Data B.V.",
        "STRAAT": "Koninginnegracht",
        "HUISNR": "46",
        "HUISNRTOEV": "1",
        "POSTCODE": "2514AD",
        "WOONPLAATS": "'s-Gravenhage",
        "TELNET": "070",
        "TELABO": "2400862",
        "EMAIL": "[email protected]",
        "URL": "www.adhocdata.nl",
        "SBIHOOFDACT": "7312",
        "OMSHOOFDACT": "7312",
        "OPRICHTINGSDATUM": 19980629,
        "MUTATIEDATUM": 20200813
      }
    ]
  },
  "result": "success",
  "dateRequest": "2026-01-01T12:00:00.000Z",
  "receipt": {
    "DataTransactionId": "3b525b51-6edb-47dc-8737-5fdc1916f4b3",
    "Records": 1
  }
}

Voorbeeld preview

Input

Voor de exacte input data, zie input.

{
  "Action": "Preview",
  "Take": 1000,
  "Skip": 0,
  "OrderBy": {
    "FANAAM": "ASC"
  },
  "Fields": [],
  "Conditions": [
    {
      "Field": "Postcode",
      "Type": "BETWEEN",
      "Value": "2514AA,2514AD"
    },
    {
      "Field": "Postcode",
      "Type": "!IN",
      "Value": "2514AB,2514AC"
    }
  ]
}

Output

Voor de exacte output data, zie output.

{
  "response": {
    "responseType": "preview",
    "data": [
      {
        "AHDNR": "ADH00000ADAZEFF",
        "FANAAM": "Ad Hoc Data B.V.",
        "WOONPLAATS": "'s-Gravenhage"
      }
    ]
  },
  "result": "success",
  "dateRequest": "2026-01-01T12:00:00.000Z"
}

Filter types

IS / !ISExacte match
IN / !INWaarde in komma-gescheiden lijst
CONTAINS / !CONTAINSBevat waarde
BETWEEN / !BETWEENRange, waarbij min/max komma-gescheiden wordt opgegeven
STARTSWITHBegint met waarde
ENDSWITHEindigt met waarde
GTGroter dan
LTKleiner dan
ANDGROUPGroep van bovengenoemde filters icm AND operator, voorbeeld:
{
  "Type": "ANDGROUP",
  "Conditions": [
    {
      "Field": "POSTCODE",
      "Type": "IS",
      "Value": "2514AA"
    },
    {
      "Field": "POSTCODE",
      "Type": "IS",
      "Value": "2514AD"
    }
  ]
}
ORGROUPGroep van bovengenoemde filters icm OR operator, voorbeeld:
{
  "Type": "ORGROUP",
  "Conditions": [
    {
      "Field": "POSTCODE",
      "Type": "IS",
      "Value": "2514AA"
    },
    {
      "Field": "POSTCODE",
      "Type": "IS",
      "Value": "2514AD"
    }
  ]
}
UNIONIN statement icm meerdere velden, voorbeeld:
{
  "Field": "sbi1,sbi2,sbi3",
  "Type": "UNION",
  "Value": "CODE1,CODE2,CODE3"
}

Velden laden…

Referentielijsten laden…

Velden laden…