Elencare i profili di registrazione

Trovare i profili di registrazione esistenti

Elenca i profili di registrazione locali attivi e non eliminati associati al tuo account API. Usa questo elenco per individuare l’UUID di un profilo prima di aprirlo con get_document, non per determinare se i relativi documenti giustificativi o la registrazione del numero siano stati approvati.

Richiesta dell’elenco

Autenticati con il tuo account API MultiTEL abilitato e il relativo indirizzo IP autorizzato. Gli esempi utilizzano credenziali HTTP Basic memorizzate in variabili d’ambiente. Controlla sia la risposta HTTP sia il campo JSON status.code; una risposta HTTP 200 da sola non conferma il successo dell’operazione. Tutti i valori degli esempi sono fittizi.

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

Questo gestore non implementa un corpo della richiesta, la paginazione o parametri di filtro. Restituisce i profili memorizzati dell’account corrispondente; non dare per scontato un ordine specifico. Per gli account di grandi dimensioni, evita di richiedere frequentemente l’elenco completo tramite polling.

Elenco nella risposta

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

Se non ci sono profili attivi corrispondenti, il gestore restituisce il codice API 200 e un elenco vuoto nella risposta. response[].id è l’UUID del profilo locale restituito come uuid durante la creazione; non è un ID di identità né un ID di indirizzo.

Campi del profilo restituiti

La proiezione contiene 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 e date_created.

I valori facoltativi possono essere vuoti o null in base ai dati memorizzati. Questa proiezione del sistema legacy omette email, i selettori del paese, identity_id, address_id, i riferimenti ai file caricati, gli elenchi dei documenti giustificativi e lo stato di verifica. Non è un endpoint per consultare lo stato dei documenti giustificativi o l’approvazione della registrazione. Tratta come riservati i dati di identità, di contatto e della firma restituiti.

Passaggi successivi

Salva gli ID delle entità dalla risposta originale di create_document per le associazioni successive. Se quella risposta è andata persa, questo elenco non consente di recuperarli. Esamina il profilo nel portale oppure contatta l’assistenza invece di creare automaticamente un duplicato.