---
title: "Send Inputs"
method: POST
path: "/{identity}/send-input"
---

# Send Inputs

`POST /{identity}/send-input`

Use this API to send documents, selfies, videos, or other identifying information

## Path parameters

- `identity` string, required

## Headers

- `Content-Type` string, required

## Request body

- object
  - `inputs` object
    - `inputType` string, required — User input type
    - `group` integer — Index of verificationSteps with given inputType in merchant configurations. Each document must have a unique group number, starting from 0. MetaMap-supported documents must precede custom documents.
    - `data` object
      - `type` string — For a MetaMap-supported document, the type of document, (driving-license, national-id, passport, proof-of-residency). For a selfie, selfie-photo. For a liveness video, selfie-video For a custom document, use the webhook label name you defined when you added the Custom Document merit to your metamap
      - `country` string — Country code. Used only for MetaMap-supported documents to specify the document's country of issue. Omit this parameter for custom documents. Uses ISO 2 codes.
      - `region` string — Used only to verify users in the United States. For non-US users, leave blank (example, ""). Refers to the user's state of residency (for example, "AL" for "Alabama"). Uses the US Postal Service state abbreviations
      - `page` string — The document's page side. 1-sided documents require only the front 2-sided documents can be uploaded as two separate files (front and back) 2-sided Custom documents can be uploaded as 2 separate image files (front and back) or as a single *.pdf file (multi) Custom documents with >2 sides must upload a single *.pdf file (multi)
      - `filename` string, required — The name of the file being uploaded.
  - `document` string, binary — MetaMap-supported documents only. Location of file to upload.
  - `custom-document` string, binary — Custom documents only. Location of file to upload.

## Response `201`

201

- union
  - object[]
    - `data` object
      - `inputType` string
      - `type` string
      - `filename` string
    - `result` boolean
  - object[]
    - `data` object
      - `inputType` string
      - `type` string
      - `filename` string
    - `error` object
      - `type` string
      - `code` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/metamap/apis/get-authorization-token.md) · [All operations](https://skmtc.net/metamap/apis/get-authorization-token/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/metamap/get-authorization-token/versions/ffdfcfeffe2a/schema)