Catalog

These endpoints let you list all the Sources, Destinations, and Destination settings that Segment supports.

Migrate from the Config API

Like the Segment Public API, the Config API has endpoints to navigate the catalog of Integrations supported by Segment. See the sections below for some key differences:

Source catalog items

Config API Public API
name See note on names vs IDs in the migration guide
displayName name
description description
categories categories
logos logos
type Removed

Destination catalog items

Config API Public API
browserUnbundlingPublic supportedFeatures.browserUnbundlingPublic
browserUnbundlingSupported supportedFeatures.browserUnbundling
categories categories
components components
description description
displayName name,
id id
logos logos
methods supportedMethods
name See note on names vs IDs in the migration guide
platforms supportedPlatforms
previousNames previousNames
settings options
slug slug
status status
type Not returned
website website

To migrate, replace any use of the Config API endpoints with the Segment Public API counterparts, using the field mappings in the table above.

Get Destination Metadata

Returns a Destination catalog item by its id.

Securitytoken
Request
path Parameters
destinationMetadataId
required
string [ 1 .. 255 ]
Responses
200

OK

404

Resource not found

422

Validation failure

429

Too many requests

get/catalog/destinations/{destinationMetadataId}
Request samples
Response samples
{
  • "data": {
    }
}

Get Destinations Catalog

Returns a list of all available Destinations in the Segment catalog.

Securitytoken
Request
query Parameters
required
object (PaginationInput)

Required pagination parameters used to filter the Destinations catalog.

This parameter exists in v1.

Responses
200

OK

404

Resource not found

422

Validation failure

429

Too many requests

get/catalog/destinations
Request samples
Response samples
{
  • "data": {
    }
}

Get Source Metadata

Returns a Source catalog item by its id.

Securitytoken
Request
path Parameters
sourceMetadataId
required
string [ 1 .. 255 ]
Responses
200

OK

404

Resource not found

422

Validation failure

429

Too many requests

get/catalog/sources/{sourceMetadataId}
Request samples
Response samples
{}

Get Sources Catalog

Returns a list of all available Sources in the Segment catalog.

Securitytoken
Request
query Parameters
required
object (PaginationInput)

Defines the pagination parameters.

This parameter exists in v1.

Responses
200

OK

404

Resource not found

422

Validation failure

429

Too many requests

get/catalog/sources
Request samples
Response samples
{}

Get Warehouse Metadata

Returns a Warehouse catalog item by its id.

Securitytoken
Request
path Parameters
warehouseMetadataId
required
string [ 1 .. 255 ]
Responses
200

OK

404

Resource not found

422

Validation failure

429

Too many requests

get/catalog/warehouses/{warehouseMetadataId}
Request samples
Response samples
{
  • "data": {
    }
}

Get Warehouses Catalog

Returns a list of all available Warehouses in the Segment catalog.

Securitytoken
Request
query Parameters
required
object (PaginationInput)

Required pagination params used to filter the Warehouses catalog.

This parameter exists in v1.

Responses
200

OK

404

Resource not found

422

Validation failure

429

Too many requests

get/catalog/warehouses
Request samples
Response samples
{}