---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/marketplace/listings/tutorial#article
headline: Marketplace Add-on Listing Tutorial
description: This tutorial provides step-by-step instructions for installing Marketplace Add-ons to your account and using the Prove TCPA Compliance Lookup Add-on.
url: https://www.twilio.com/docs/marketplace/listings/tutorial
inLanguage: en
dateModified: 2026-08-20T18:09:16.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# Marketplace Add-on Listing Tutorial

This tutorial shows how to install and use the Prove TCPA Compliance Marketplace Add-on with the Twilio Lookup API to verify that a phone number is active and still owned by the customer. For more detailed instructions on installing and configuring an Add-on listing, see the [Marketplace listings usage guide](/docs/marketplace/listings/usage#installation-1).

## Install an add-on listing

Install and enable Add-on listings through the Twilio Console. Once installed, they enhance specific Twilio APIs, such as [Twilio Voice](/docs/voice) and [Programmable Messaging](/docs/messaging). The Prove TCPA Compliance Add-on helps ensure a number is compliant with Telephone Consumer Protection Act (TCPA) regulations.

To install the Prove TCPA Compliance Add-on, follow these steps:

1. Select **Prove TCPA Compliance** from the catalog.
2. Click **Install**.
3. Under the **Configure** tab, check the **Lookups** box.
4. View all installed Marketplace Add-ons by clicking on **Marketplace > Installed**.

## Use the Prove TCPA Compliance Add-on listing

The Prove TCPA Compliance Add-on lets you verify whether a phone number is active and still owned by the customer before sending an SMS message, which helps ensure compliance with TCPA regulations.

To use this Add-on, install it like the Trestle Reverse Phone Add-on. Go to the [Add-on catalog](https://www.twilio.com/console/add-ons), locate and select Prove TCPA Compliance, and select **Install**.

![Add-ons Prove TCPA Compliance.](https://docs-resources.prod.twilio.com/a23853da53ba0d2710b470125e4cfaae3c1722e3dbae6d95a921983860548608.png)

Since the goal is to leverage the [Twilio Lookup API](/docs/lookup/v2-api) to find TCPA compliance information for a phone number, check the **Lookups** box under the **Configure** tab of the Prove TCPA Compliance Add-on. Afterwards, query for the TCPA compliance information on the target phone number using the following code:

```bash title="Look up TCPA compliance for a phone number"
curl --location --request GET 'https://lookups.twilio.com/v1/PhoneNumbers/+18005550100/?AddOns=prove_tcpa_compliance&AddOns.prove_tcpa_compliance.RightPartyContactedDate=20160101' -u $TWILIO_API_KEY:$TWILIO_API_SECRET
```

Example response:

```json title="Prove TCPA Compliance Add-on response"
{
    "Status": 0,
    "Description": "Success",
    "RequestId": "7f83-b0c4-90e0-90b3-11e10800200c9a66",
    "Response": {
        "VerifyNumberTransactionId": "144356671",
        "PayfoneAlias": "C24C4C54DR10481C4E0U44ERMVUP9S1TUNXPLA2T753ETMCFOA086TYMCAQL00B4E0CLC4C24BHZPO4QWPN68EAV14ERTVPMMEP7OCXTRBQR17YERTMK749",
        "MSISDNType": "Mobile",
        "NumberMatch": "Y"
    }
}
```

The results from the TCPA Compliance Lookup are organized into a structured format. The key `NumberMatch` indicates `Y` for a compliant number, `N` for a non-compliant number, and `I` for an indeterminate number. The response also includes keys related to the identification of the device claiming ownership of the number. For demographic and carrier information, use the Trestle Reverse Phone Add-on.

For more information on using Marketplace Add-ons, refer to the [How to use Add-on Listings Guide](/docs/marketplace/listings/usage#add-on-listings).