Registratieprofielen opvragen

Bestaande registratieprofielen vinden

Vraag de actieve, niet-verwijderde lokale registratieprofielen op die aan uw API-account zijn gekoppeld. Gebruik dit om de UUID van een profiel te vinden voordat u het opent met get_document, niet om vast te stellen of de bijbehorende bewijsstukken of nummerregistratie zijn goedgekeurd.

Verzoek om de lijst op te vragen

Authenticeer met uw ingeschakelde MultiTEL API-account en het daarvoor toegestane IP-adres. De voorbeelden gebruiken HTTP Basic-inloggegevens die in omgevingsvariabelen zijn opgeslagen. Controleer zowel de HTTP-respons als het JSON-veld status.code; alleen een HTTP 200-respons toont niet aan dat het verzoek is geslaagd. Alle voorbeeldwaarden zijn fictief.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/documents

Deze handler ondersteunt geen verzoekinhoud, paginering of filterparameters. De handler retourneert de opgeslagen profielen van het bijbehorende account; ga niet uit van een bepaalde volgorde. Vermijd het veelvuldig opvragen van de volledige lijst bij grote accounts.

Lijst in de respons

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": [
    {
      "id": "11111111111111111111111111111111",
      "first_name": "Example",
      "last_name": "Person",
      "phone_number": "12025550123",
      "id_number": "",
      "birth_date": null,
      "company_name": "",
      "company_reg_number": "",
      "vat_id": "",
      "personal_tax_id": "",
      "description": "Example profile",
      "identity_type": "Personal",
      "postal_code": "00000",
      "city": "Example City",
      "address": "1 Example Street",
      "signature": "BASE64_PNG_SIGNATURE_DATA",
      "date_created": "2026-10-23 16:00:00"
    }
  ]
}

Als er geen overeenkomende actieve profielen zijn, retourneert de handler API-code 200 en een lege responslijst. response[].id is de UUID van het lokale profiel die bij het aanmaken als uuid wordt geretourneerd; dit is geen identiteits-ID of adres-ID.

Geretourneerde profielvelden

De veldselectie bevat id, first_name, last_name, phone_number, id_number, birth_date, company_name, company_reg_number, vat_id, personal_tax_id, description, identity_type, postal_code, city, address, signature en date_created.

Optionele waarden kunnen leeg of null zijn, afhankelijk van de opgeslagen gegevens. Deze veldselectie uit de oudere implementatie bevat geen email, landselectievelden, identity_id, address_id, verwijzingen naar geüploade bestanden, lijsten met bewijsstukken of verificatiestatus. Dit is geen endpoint voor de status van bewijsstukken of de goedkeuring van registraties. Behandel de geretourneerde identiteitsgegevens, contactgegevens en handtekeninggegevens als vertrouwelijk.

Volgende stappen

Bewaar de entiteits-ID's uit het oorspronkelijke create_document-antwoord om later koppelingen te kunnen maken. Als dat antwoord verloren is gegaan, kunt u deze ID's niet met deze lijst terughalen. Bekijk het profiel in het portaal of neem contact op met de ondersteuning in plaats van automatisch een duplicaat aan te maken.