Ontwikkelaars

GET/v3/get_document/{uuid}

Een registratieprofiel ophalen

Haal één actief profiel van uw account op via de UUID van het lokale document.

Op deze pagina
  1. Eén opgeslagen profiel ophalen
  2. Profielaanvraag
  3. Profielrespons
  4. Geretourneerde profielvelden
  5. Niet gevonden en opnieuw proberen

Eén opgeslagen profiel ophalen

Haal het actieve lokale registratieprofiel binnen uw account op aan de hand van de bijbehorende UUID. Dit levert dezelfde beperkte set profielvelden op als documents; de verificatie door de telecomaanbieder wordt hiermee niet vernieuwd en bijgevoegde bewijsstukken worden niet geretourneerd.

Profielaanvraag

Authenticeer met uw ingeschakelde MultiTEL API-account vanaf 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 bevestigt niet dat de aanvraag is geslaagd. Alle voorbeeldwaarden zijn fictief.

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

Stel DOCUMENT_UUID in op response.uuid uit de respons van create_document, of op response[].id uit de respons van documents. Gebruik hier geen identity_id, address_id, ID van een bewijsstuk of telefoonnummer. Er is geen aanvraagbody nodig.

Profielrespons

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "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"
  }
}

Geretourneerde profielvelden

De geretourneerde 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, afhankelijk van de opgeslagen gegevens, leeg zijn of null bevatten. Deze verouderde veldselectie bevat geen email, landkeuzevelden, identity_id, address_id, verwijzingen naar geüploade bestanden, lijsten met bewijsstukken of verificatiestatus. Dit eindpunt is niet bedoeld om de status van bewijsstukken of de goedkeuring van een registratie op te vragen. Behandel de geretourneerde identiteits-, contact- en handtekeninggegevens als vertrouwelijk.

Niet gevonden en opnieuw proberen

API-code 404 met de melding Failed, Not found betekent dat er voor dit account en deze UUID geen overeenkomend actief profiel is gevonden. Controleer het account, de identificatiecode en of het profiel is verwijderd. Met deze zoekopdracht wordt het profiel van een ander account niet vrijgegeven.

Het succesvol ophalen van gegevens bevestigt niet dat bewijsstukken zijn geaccepteerd of dat een nummer is geactiveerd. Als u de verwerking hervat na een aanvraag om iets aan te maken of bij te voegen waarvan de uitkomst onzeker is, controleer dan het document in het portaal voordat u opnieuw een aanvraag doet die de toestand wijzigt.