---
title: "Submit an individual's name, postal address, and/or email to append the individual's relevant contact information or email risk score."
method: POST
path: "/identity/append/v1"
tags: ["Identity Append (USA only)"]
---

# Submit an individual's name, postal address, and/or email to append the individual's relevant contact information or email risk score.

`POST /identity/append/v1`

## Headers

- `Reference-Id` string
- `Timeout-Seconds` integer
- `Add-Metadata` boolean

## Request body

- IdentityAppendRequest — The request model. For more information on what elements are mandatory or optional, please visit the Technical Documentation site for <a href="https://docs.experianaperture.io/identity-append/experian-identity-append/api-reference/email-append/">Email Append</a>, <a href="https://docs.experianaperture.io/identity-append/experian-identity-append/api-reference/reverse-email-append/">Reverse Email Append</a>, <a href="https://docs.experianaperture.io/identity-append/experian-identity-append/api-reference/phone-append/">Phone Append</a> and <a href="https://docs.experianaperture.io/identity-append/experian-identity-append/api-reference/risk-score/">Risk Score</a>.
  - `components` IdentityAppendInputComponents, required — The identity input component.
    - `first_name` string[], nullable — The first name of the individual.
    - `middle_name` string[], nullable — The middle name of the individual.
    - `last_name` string[], nullable — The last name of the individual.
    - `address_line_1` string[], nullable — The first line of the individual’s address.
    - `town` string[], nullable — The town, city or suburb of the individual’s address.
    - `sub_region` string[], nullable — The county of the individual’s address.
    - `region` string[], nullable — The state or province abbreviation of the individual’s address.
    - `postal_code` string[], nullable — The postal code of the individual’s address.
    - `email` string[], nullable — The email of the individual.
    - `phone` string[], nullable — The phone number of the individual.
    - `country_iso_2` string[], nullable — The country of the individual in two letter ISO code.
    - `ip_address` string[], nullable — The ip address of the individual.
    - `user_agent` string[], nullable — The user agent of the individual.
  - `options` IdentityAppendInputOptions[], nullable — The identity append request options.
    - `name` string, nullable — The name of the option.
    - `value` string, nullable — The value of the option.
  - `attributes` string[], required — Type of the request.

## Response `200`

OK

- IdentityAppendResponse — The response model.
  - `error` ResponseError — Error model containing the error details.
    - `type` string, nullable — A link to documentation that provides more details about the error you’ve encountered.
    - `title` string, nullable — The title of the error.
    - `detail` string, nullable — A description of the error.
    - `instance` string, nullable — The endpoint that returned the error.
  - `result` IdentityAppendResult — Details about the result, such as email, contact, or risk score.
    - `email` string, nullable — The email of the individual.
    - `contacts` IdentityAppendContactResponse[], nullable
      - `first_name` string, nullable — The first name of the individual.
      - `last_name` string, nullable — The last name of the individual.
      - `address_line_1` string, nullable — The first line of the individual’s address.
      - `town` string, nullable — The town, city or suburb of the individual’s address.
      - `region` string, nullable — The state or province abbreviation of the individual’s address.
      - `postal_code` string, nullable — The postal code of the individual’s address.
      - `country_iso_3` string, nullable — The country iso 3 of the individual’s address.
    - `risk` EmailRiskResult — The risk of a fraudulent profile.
      - `score` integer, nullable — A score indicating the risk level. Low score: 0, High score: 100
      - `tumbling_risk` integer, nullable — A score indicating multiple variations of the same email address. 0 indicates no tumbling detected, while values of 1, 2 and 3 indicated a linear risk of tumbling detected.
      - `domain_risk` integer, nullable — A score indicating the domain risk level, based on historical information and industry data. Low score: 0, High score: 10.
    - `phones` string[], nullable — The matched phone number(s) of the individual.
  - `metadata` IdentityAppendMetadata — The metadata model.
    - `email_detail` IdentityAppendEmailDetail — Additional fields details that can be returned alongside the Identity Append result.
      - `email_type` string, nullable — The type of email based on its classification of intended purpose, i.e. individual, business or education.
      - `date_first_seen` string, nullable — The date the email address first appeared in the records.
      - `longevity` integer, nullable — A score relating to when the email address was first discovered. From 0 (not discovered) to 3 (Discovered over a year ago).
      - `velocity` integer, nullable — A score reflecting the activity of the email address over the last 6 months, from 0 (no activity) to 10 (most active).
      - `popularity` integer, nullable — A score assessing the email address's visibility over the last 12 months based on the number of sources that have received the address, ranging from 0 (no sources) to 10 (most sources).
      - `domain` IdentityAppendEmailDetailDomain — The Email Detail metadata Domain info.
        - `date_first_seen` string, nullable — The date the domain first appeared in the records. The value "now" will be returned if the domain is new.
        - `longevity` integer, nullable — A score relating to when the domain was first discovered. From 0 (not discovered) to 3 (Discovered over a year ago).
        - `velocity` integer, nullable — A score reflecting the activity of the domain over the last 6 months, from 0 (no activity) to 10 (most active).
        - `popularity` integer, nullable — A score assessing the domain's visibility over the last 12 months based on the number of sources that have received the address, ranging from 0 (no sources) to 10 (most sources).
        - `domain_type` string, nullable — The type of domain.
      - `confidence` string, nullable — The outcome (confidence level) of the validation.
      - `verbose_output` string, nullable — The verbose output of the validation.
      - `verbose_reason` string, nullable — The verbose output description of the validation.
    - `address_detail` IdentityAppendAddressDetail — The Address Detail metadata.
      - `first_name_match` string, nullable — Checks to see if the first name matches first names previously associated with that email.
      - `last_name_match` string, nullable — Checks to see if the last name matches last names previously associated with that email.
      - `address_line_1_match` string, nullable — Checks to see if the address line matches the address line previously associated with that email.
      - `town_match` string, nullable — Checks to see if the town matches the town data previously associated with that email.
      - `postal_code_match` string, nullable — Checks to see if the postal code matches the postal code data previously associated with that email.
      - `deliverability` string, nullable — Checks if the address is deliverable.
      - `deliverability_detail` string, nullable — Deliverable sub status.
      - `address_type` IdentityAppendAddressDetailAddressType — The Address Detail metadata's address type information.
        - `code` string, nullable — Indicates the address type.
        - `description` string, nullable — Indicates the description of the code.
    - `ip_detail` IdentityAppendIpDetail — The Ip Address Detail metadata.
      - `routing_type` string, nullable — Indicates the IP Routing Type (IPRT), which specifies how the connection is routed through the Internet and can be used to determine how close the user is to the public IP address.
      - `organization` string, nullable — The registering organization, which can include many types of entities, including corporate, government, or educational entities, and ISPs managing the allocation and use of network blocks.
      - `proxy_type` string, nullable — The network or protocol utilized by the server to proxy the user connection is identified.
      - `hosting_facility` boolean, nullable — A value of "true" indicates that the IP address is associated with a hosting facility; otherwise the value is "false".
      - `latitude` number, double, nullable — The latitude of the identified location.
      - `longitude` number, double, nullable — The longitude of the identified location.
    - `phone_detail` IdentityAppendPhoneDetail[], nullable
      - `phone_type` string, nullable — The type of phone based on its classification of intended purpose, i.e. mobile, landline, pager or unknown.
      - `number` string, nullable — The phone number of the individual.
      - `dnc` boolean, nullable — A value of "true" indicates that the phone number appears on the Do Not Call list; otherwise the value is "false"
      - `dnc_date_revised` string, nullable — The last date the phone number appeared on the Do Not Call list.
      - `rank` integer, nullable — The rank of the phone number most likely in use by the individual.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `406` — Not Acceptable
- `408` — Request Timeout
- `415` — Unsupported Media Type
- `429` — Too Many Requests
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.dev/experianaperture/apis/aperture-rest-api.md) · [All operations](https://skmtc.dev/experianaperture/apis/aperture-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/experianaperture/aperture-rest-api/revisions/f17d329b4892/schema)