# CREATE REQUEST

Creates a new request for digital certificate issuance. ⚠ Each certificate profile has its own set of fields. Please check the list of fields in the Certificate Profiles section.

Endpoint: POST /api/v1/requests
Version: v1

## Request fields (application/json):

  - `profile` (string, required)
    Certificate profile

  - `validity_time` (number)
    Validity time for the certificate (value in days). Values are subject to the certificate profile that is being used.

  - `scratchcard` (string, required)
    Available and unused scratchcard serial number. The first unused scratchcard serial number can be obtained in the Get first unused call

  - `secure_element` (string)
    Can be 0, 1 or 2 which stands respectively to Software, Smartcard and Cloud

  - `registration_authority` (string, required)
    The unique identifier (PK) of the RA (it's assigned when is created)

  - `identification_rao` (number)
    The ID of Operator in charge of identifying, this Operator has to be registered as 'Identification RAO' in the respective Registration Authority. You are able to check it through Get RAO call response, explicitly in is_identificator field. This field is required if the approval Operator is not the same as the identifier

  - `country_name` (string)
    The country where the RA is registered

  - `serial_number` (string)
    The user's document serial number

  - `id_document_country` (string)
    The user's id document country two-letters code (ISO 3166-1 alpha-2)

  - `id_document_type` (string)
    The user's document type

  - `given_name` (string)
    The user's given name

  - `surname_1` (string)
    The user's first surname

  - `surname_2` (string)
    The user's second surname

  - `email` (string, required)
    The user's email

  - `mobile_phone_number` (string)
    The user's mobile phone number

  - `paperless_mode` (number)
    This parameter must be included and set to 1 for a classic certificate request

  - `videoid_mode` (number)
    This parameter must be included and set to 1 for a Video ID certificate request

  - `webhook_url` (string)
    The webhook associated URL.  ⚠ Not required for external authentication. See Webhook Configuration section

## Response 400 fields (application/json):

  - `detail` (string)
    JSON syntax error description

## Response 500 fields (application/json):

  - `code` (string)
    The response status code

  - `id` (string)
    The response status id

  - `error` (string)
    The response status message