Lue rekisteröintiprofiili

Lue yksi tallennettu profiili

Hae tilisi aktiivinen paikallinen rekisteröintiprofiili sen UUID-tunnisteen perusteella. Tämä palauttaa saman rajatun joukon profiilikenttiä kuin documents; se ei päivitä operaattorin varmennusta eikä palauta liitettyjä todistusasiakirjoja.

Profiilin hakupyyntö

Tunnistaudu käyttöön otetulla MultiTEL API -tililläsi ja tilille sallitusta IP-osoitteesta. Esimerkeissä käytetään ympäristömuuttujiin tallennettuja HTTP Basic -tunnuksia. Tarkista sekä HTTP-vastaus että seuraava JSON-vastauksen kenttä: status.code; pelkkä HTTP 200 -vastaus ei vahvista pyynnön onnistumista. Kaikki esimerkkien arvot ovat kuvitteellisia.

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

Aseta muuttujan DOCUMENT_UUID arvoksi response.uuid seuraavan kutsun vastauksesta: create_document, tai käytä arvoa response[].id kutsun documents vastauksesta. Älä käytä tässä arvoa identity_id tai address_id, todistusasiakirjan tunnistetta tai puhelinnumeroa. Pyynnön runkoa ei tarvita.

Profiilin hakuvastaus

{
  "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"
  }
}

Palautettavat profiilikentät

Kenttävalikoima sisältää kentät 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 ja date_created.

Valinnaiset arvot voivat olla tyhjiä tai null tallennettujen tietojen mukaan. Tämä vanha kenttävalikoima jättää pois kentän email, maavalitsimet, kentät identity_id ja address_id, viittaukset ladattuihin tiedostoihin, todistusasiakirjojen luettelot ja varmennuksen tilan. Tämä ei ole todistusasiakirjojen tilan tai rekisteröinnin hyväksynnän tarkistamiseen tarkoitettu rajapinnan päätepiste. Käsittele palautettuja henkilöllisyys-, yhteys- ja allekirjoitustietoja yksityisinä.

Profiilia ei löydy ja uudelleenyritykset

API-koodi 404 ja viesti Failed, Not found tarkoittavat, ettei tälle tilille ja UUID-tunnisteelle löytynyt vastaavaa aktiivista profiilia. Tarkista tili, tunniste ja se, onko profiili poistettu. Tämä haku ei paljasta toisen tilin profiilia.

Onnistunut luku ei vahvista todistusasiakirjojen hyväksymistä tai numeron aktivointia. Jos selvität luonti- tai liittämispyyntöä, jonka lopputulos on epävarma, tarkista asiakirja portaalissa ennen uuden tilaa muuttavan pyynnön tekemistä.