Skip to main content
POST
/
v3
/
poa
Proof of Address
curl --request POST \
  --url https://verification.didit.me/v3/poa/ \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form document='@example-file' \
  --form 'expected_address=<string>' \
  --form 'expected_country=<string>' \
  --form 'expected_first_name=<string>' \
  --form 'expected_last_name=<string>' \
  --form 'poa_languages_allowed=<string>' \
  --form 'poa_document_age_months=utility_bill:3,bank_statement:3,government_issued_document:3' \
  --form poa_name_mismatch_action=DECLINE \
  --form poa_document_issues_action=DECLINE \
  --form poa_document_authenticity_action=DECLINE \
  --form poa_unsupported_language_action=DECLINE \
  --form poa_address_mismatch_action=DECLINE \
  --form poa_issuer_not_identified_action=DECLINE \
  --form save_api_request=true \
  --form 'vendor_data=<string>'
{
  "request_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
  "poa": {
    "status": "Declined",
    "issuing_state": "AR",
    "document_type": "UTILITY_BILL",
    "document_language": "es",
    "document_metadata": {
      "file_size": 1000,
      "content_type": "application/pdf",
      "creation_date": "2021-01-01",
      "modified_date": "2021-01-01"
    },
    "issuer": "Aguas del Norte",
    "issue_date": "2021-02-01",
    "poa_address": "AVDA. MONSEÑOR TAVELLA N° 3396, SALTA",
    "poa_formatted_address": "Av. Monseñor Tavella 3396, A4400 Salta, Argentina",
    "poa_parsed_address": {
      "address_type": "Avenida",
      "street_1": "Avenida Monseñor Tavella 3396",
      "street_2": null,
      "city": "Salta",
      "region": "Salta",
      "country": "AR",
      "postal_code": "A4400",
      "document_location": {
        "latitude": -24.8208664,
        "longitude": -65.4131
      }
    },
    "expected_details_address": null,
    "expected_details_formatted_address": null,
    "expected_details_parsed_address": {},
    "name_on_document": "Sophia Grace Martinez",
    "extra_fields": {
      "bank_account_number": "1234567890",
      "bank_iban": null,
      "bank_sort_code": null,
      "bank_routing_number": null,
      "bank_swift_bic": null,
      "bank_branch_name": null,
      "bank_branch_address": null,
      "document_phone_number": "+5491112345678",
      "additional_names": []
    },
    "warnings": [
      {
        "risk": "EXPIRED_DOCUMENT",
        "additional_data": null,
        "log_type": "error",
        "short_description": "Document expired",
        "long_description": "The submitted document is older than 90 days from its issue date, which exceeds the acceptable time period for validity."
      }
    ],
    "created_at": "2025-05-01T13:11:07.977806Z"
  }
}

Authorizations

​
x-api-key
string
header
required

Body

multipart/form-data
​
document
file
required

Proof of address document. Allowed formats: PDF, JPEG, PNG, WebP, TIFF. Maximum file size: 15MB.

​
expected_address
string

Expected address to cross-validate with the data extracted in the POA document.

​
expected_country
string

Expected country to cross-validate with the data extracted in the POA document.

​
expected_first_name
string

Expected first name to cross-validate with the data extracted in the POA document.

​
expected_last_name
string

Expected last name to cross-validate with the data extracted in the POA document.

​
poa_languages_allowed
string

Comma-separated list of allowed language codes (e.g., en,es,fr). If blank or not provided, defaults are used. You can find a list of supported languages here.

​
poa_document_age_months
string
default:utility_bill:3,bank_statement:3,government_issued_document:3

Comma-separated key:value pairs for document age limits (e.g., utility_bill:3,bank_statement:3). If blank or not provided, defaults are used.

​
poa_name_mismatch_action
enum<string>
default:DECLINE

Action to take when there is a mismatch between the name provided (first name, last name, or both), and the extracted name from the POA document. Must be one of NO_ACTION or DECLINE.

Available options:
NO_ACTION,
DECLINE
​
poa_document_issues_action
enum<string>
default:DECLINE

Action to take when the document quality or file integrity is poor. Must be one of NO_ACTION or DECLINE.

Available options:
NO_ACTION,
DECLINE
​
poa_document_authenticity_action
enum<string>
default:DECLINE

Action to take when document manipulation or authenticity is suspected. Must be one of NO_ACTION or DECLINE.

Available options:
NO_ACTION,
DECLINE
​
poa_unsupported_language_action
enum<string>
default:DECLINE

Action to take when the document language is not supported. Must be one of NO_ACTION or DECLINE.

Available options:
NO_ACTION,
DECLINE
​
poa_address_mismatch_action
enum<string>
default:DECLINE

Action to take when there is a mismatch between the expected address and the address extracted from the POA document. Must be one of NO_ACTION or DECLINE.

Available options:
NO_ACTION,
DECLINE
​
poa_issuer_not_identified_action
enum<string>
default:DECLINE

Action to take when the issuer is not identified. Must be one of NO_ACTION or DECLINE.

Available options:
NO_ACTION,
DECLINE
​
save_api_request
boolean
default:true

Whether to save this API request. If true, then it will appear on the Manual Checks section in the Business Console.

​
vendor_data
string

A unique identifier for the vendor or user, such as a UUID or email. This field enables proper session tracking and user data aggregation across multiple verification sessions.

Response

​
request_id
string
​
poa
object