Search for destinations

Searches for destinations.

POST /1/destinations/search

curl

cURL

curl --request POST \
  --url https://data.us.algolia.com/1/destinations/search \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'x-algolia-api-key: ALGOLIA_API_KEY' \
  --header 'x-algolia-application-id: ALGOLIA_APPLICATION_ID' \
  --data '
{
  "destinationIDs": [
    "6c02aeb1-775e-418e-870b-1faccd4b2c0f"
  ]
}
'

200

[
  {
    "createdAt": "<string>",
    "destinationID": "6c02aeb1-775e-418e-870b-1faccd4b2c0f",
    "input": {
      "indexName": "<string>",
      "attributesToExclude": [
        "<string>"
      ]
    },
    "name": "<string>",
    "updatedAt": "<string>",
    "authenticationID": "6c02aeb1-775e-418e-870b-1faccd4b2c0f",
    "owner": "<string>",
    "transformationIDs": [
      "6c02aeb1-775e-418e-870b-1faccd4b2c0f"
    ]
  }
]

Required ACL: addObject, deleteIndex, editSettings

Authorizations

x-algolia-application-id · string · header · required

Your Algolia application ID.

x-algolia-api-key · string · header · required

Your Algolia API key with the necessary permissions to make the request. Permissions are controlled through access control lists (ACL) and access restrictions. The required ACL to make a request is listed in each endpoint's reference.

Body

application/json

API request body for searching destinations.

destinationIDs · string[] · required

Universally unique identifier (UUID) of a destination resource.

Response

200

application/json

OK

createdAt · string · required

Date and time when the resource was created, in RFC 3339 format.

destinationID · string · required

Universally unique identifier (UUID) of a destination resource.

Example:

"6c02aeb1-775e-418e-870b-1faccd4b2c0f"

input · object · required

Show child attributes

name · string · required

Descriptive name for the resource.

type · enum<string> · required

Destination type.

• search. Data is stored in an Algolia index.

• insights. Data is recorded as user events in the Insights API.

Available options: search, insights

updatedAt · string · required

Date and time when the resource was last updated, in RFC 3339 format.

authenticationID · string

Universally unique identifier (UUID) of an authentication resource.

Example:

"6c02aeb1-775e-418e-870b-1faccd4b2c0f"

owner · string | null

Owner of the resource.

transformationIDs · string[]

Universally unique identifier (UUID) of a transformation.