Sign in
Application Creation

Submits data for a new application draft (NuovaDomandaInBozza)

Changed on

Invoked when the status is READY_FOR_NEW_DRAFT (or to replace an existing draft). The client supplies an Idempotency-Key identifying the user action: re-sending the same key is a safe retry, while a new key replaces the current draft (INPS cancels it and issues a new idLavorazione, invalidating any previously uploaded photo/documents).

post/request

Request

  • Base URL: https://api.your-bff.it/v1
  • URL: https://api.your-bff.it/v1/request
  • Auth: HTTP bearer

Headers

Idempotency-Keystring uuid required

Client-generated UUID identifying a single user action (intent). The same key MUST be reused when retrying the same action (e.g. after a network timeout) so the operation is replayed safely. A new key signals a new intent: replace the draft, overwrite the photo, etc. The BFF maps this client key to the per-step INPS Idempotency-Key it persists, guaranteeing the local record stays reconcilable with the INPS source of truth.

Request body

informativaPrivacyboolean required

1=Acceptance of privacy policy

nomestring required

Full name

cognomestring required

Full surname

sesso'M' | 'F' required

Gender

statoNascitastring required

Full description of the State of Birth

comuneNascitastring nullable

Full description of the Municipality of Birth (Required if statoNascita is ITALIA)

siglaProvinciaNascitastring nullable

Province abbreviation of Birth (Required if statoNascita is ITALIA)

dataNascitastring date-time required

Date of birth

idCittadinanzainteger required

0=Italiana, 2=Paesi comunitari, 3=Paesi extracomunitari

dataScadenzaPermessoSoggiornostring date-time nullable

Permit expiration date (Required only if idCittadinanza = 3)

pressoNomestring nullable

Optional name for delivery

pressoCognomestring nullable

Optional surname for delivery. Pair PRESSO NOME/COGNOME is exclusive of PRESSO DENOMINAZIONE.

pressoDenominazionestring nullable

Optional Denomination for delivery. Length must not exceed 40 characters.

siglaProvinciaRecstring required

Province abbreviation for delivery address

descrizioneComuneRecstring required

Municipality description for delivery address

capRecstring required

ZIP code for delivery address

indirizzoRecstring required

Delivery address (max 30 characters)

civicoRecstring nullable

House number (max 10 characters)

datiAggiuntiviRecstring nullable

Additional address data (max 45 characters)

Response

Application saved as draft. Next state returned.

state'READY_FOR_NEW_DRAFT' | 'DRAFT' | 'READY_FOR_PHOTO_UPLOAD' | 'UPLOADING_PHOTO' | 'READY_FOR_DOCUMENTS_UPLOAD' | 'UPLOADING_DOCUMENTS' | 'ACQUIRED'

Internal workflow state (managed by the BFF/DB) that guides the FE's display logic.

idLavorazionestring

INPS idLavorazione associated with the application

Changes