This endpoint returns the data of a given Listing

GET /v1/Listing/{Sid}
Account sid auth token

This endpoint returns the data of a given Listing. To find a Listing's SID, use the Available Add-ons resource or view its Listing details page in the Console by visiting the Catalog or the My Listings tab and selecting the Listing.

Path parameters

  • Sid string Required

    The unique identifier of a Listing.

    Minimum length is 34, maximum length is 34. Format should match the following pattern: ^XB[0-9a-fA-F]{32}$.

Responses

  • 200 application/json

    OK

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

    Hide response attributes Show response attributes object
    • url string(uri) | null

      URL to query the subresource.

    • sid string | null

      ModuleSid that identifies this Listing.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^XB[0-9a-fA-F]{32}$.

    • description object | null

      A JSON object describing the module and is displayed under the Description tab of the Module detail page. You can define the main body of the description, highlight key features or aspects of the module and if applicable, provide code samples for developers

    • support object | null

      A JSON object containing information on how customers can obtain support for the module. Use this parameter to provide details such as contact information and support description.

    • policies object | null

      A JSON object describing the module's privacy and legal policies and is displayed under the Policies tab of the Module detail page. The maximum file size for Policies is 5MB

    • module_info object | null

      A JSON object containing essential attributes that define a module. This information is presented on the Module detail page in the Twilio Marketplace Catalog. You can pass the following attributes in the JSON object

    • documentation object | null

      A JSON object for providing comprehensive information, instructions, and resources related to the module

    • configuration object | null

      A JSON object for providing listing specific configuration. Contains button setup, notification url, among others.

    • pricing object | null

      A JSON object for providing Listing specific pricing information.
GET /v1/Listing/{Sid} 
curl \
 --request GET 'https://marketplace.twilio.com/v1/Listing/{Sid}' \
 --user "username:password"
Response examples (200) 
{
  "sid": "XBaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "url": "https://marketplace.twilio.com/v1/Listing/XBaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "pricing": {
    "body": "Basic plan - $10/month"
  },
  "support": {
    "billing_email": "anEmail",
    "billing_phone": "+1 888-888-8888",
    "technical_email": "anEmail",
    "technical_phone": "+1 888-888-8888",
    "support_description": "aDescription",
    "customer_support_email": "anEmail",
    "customer_support_phone": "+1 888-888-8888"
  },
  "policies": {
    "legal": "someOtherUrl",
    "privacy": "someUrl"
  },
  "description": {
    "body": "aBody",
    "highlights": [
      {
        "title": "aTitle",
        "description": "aDescription"
      }
    ],
    "code_samples": [
      {
        "code": "aCode",
        "title": "aTitle",
        "description": "aDescription"
      }
    ]
  },
  "module_info": {
    "tag": "Description",
    "tagline": "aTagline",
    "logo_url": "aUrl",
    "logo_bg_color_hex": "#ff5722"
  },
  "configuration": {
    "buttons": [
      {
        "url": "https://example.com",
        "label": "Configurable button text",
        "help_text": "The button text, url, and help text are now configurable via self service"
      }
    ],
    "notification_configuration": {
      "callback_url": "https://example.com"
    }
  },
  "documentation": {
    "body": "aBody"
  }
}