# Add files to candidate

Adds a file (e.g. ID, signature) to candidate. If is_signature is true, candidate is submitted (consent implied).

Endpoint: POST /candidates/{partner_application_id}/files
Version: 1.0.0
Security: bearerAuth

## Path parameters:

  - `partner_application_id` (string, required)
    value of candidate.partner_application_id

## Request fields (application/json):

  - `data` (string, required)
    Base64 encoded file (e.g. data:image/jpeg;base64,...)
    Example: "data:image/jpeg;base64,...."

  - `id_type` (string, required)
    Enum: "drivers_license", "passport", "nz_passport", "firearm_license", "card_18", "birth_certificate", "citizenship_certificate", "centrelink_card", "id"

  - `is_signature` (boolean)
    If true, file contains candidate signature and candidate is submitted.

## Response 200 fields (application/json):

  - `result` (object)

  - `result.id` (integer)
    Example: 2589

  - `result.file_name` (string)
    Example: "dummy_result.pdf"

  - `result.file_type` (string)
    Example: "application/pdf"

  - `result.created_at` (string)
    Example: "2021-07-03T16:44:56+02:00"

  - `result.url` (string)
    Expires after 20 minutes; refreshes on each request
    Example: "https://checkmate-staging.s3.ap-southeast-2.amazonaws.com/backg..."

  - `status` (integer)
    Example: 200

  - `error` (object,null)