---
title: "Submits a phone number to get the reverse phone append."
method: POST
path: "/phone/append/v1"
tags: ["Reverse Phone Append (USA only)"]
---

# Submits a phone number to get the reverse phone append.

`POST /phone/append/v1`

## Headers

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

## Request body

- RpaV1Request — Reverse Phone Append request.
  - `number` string, required — 10-digit unformatted phone number. This value cannot contain non-numeric characters such as parentheses, dashes, or spaces

## Response `200`

OK

- RpaV1Response — Reverse Phone Append response.
  - `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` RpaV1Result — Reverse Phone Append result.
    - `number` string, nullable — The phone number.
    - `confidence` 'Verified' | 'Unverified'
    - `first_name` string, nullable — The first name.
    - `middle_name` string, nullable — The middle name.
    - `last_name` string, nullable — The last name.
    - `address` RpaV1Address — Reverse Phone Append Address.
      - `address_line1` string, nullable — The first line of the address.
      - `address_line2` string, nullable — The second line of the address.
      - `city` string, nullable — The city.
      - `state` string, nullable — The state.
      - `zip5` string, nullable — The Zip5 of the address.
      - `zip4` string, nullable — The Zip4 of the address.
      - `confidence` 'Verified' | 'Unverified'
  - `metadata` RpaV1Metadata
    - `phone_detail` RpaV1PhoneDetail — Reverse Phone Append Phone details.
      - `input_phone_type` 'Landline' | 'Mobile' | 'Other'

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `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)