Skip to content

Retrieve Data Item

Retrieve a single data item in your project.

Endpoint

https://next.seen.io/v1/projects/{Project_ID}/data/{Data_ID}

You can find your endpoint in the Run page of your project.

Request Method

GET

Request Headers

Authorization

This header is common to all requests to our API. Please see the Authorization section for more details.

Content-Type

Content-Type should be configured as application/json.

You can copy the headers from the Run page of your project.

Path Parameters

The following parameter is required in the request:

ParameterTypeDescription
Data IDStringThe id value returned when the data item was created via Create Data.

Example Request

https://next.seen.io/v1/projects/{Project_ID}/data/12345

Rate Limit

Seen API accepts up to 100 requests per 10 seconds.

Responses

Upon posting the request, you will receive one of the following responses from our API:

200

Upon a successful request, you will receive a 200 OK response.

json
{
  "id": "12345",
  "journeyOutputs": [
    {
      "id": "...",
      "motions": [
        {
          "emailThumbnail": "https://motions.seen.io/2b183354-3aa3-4eda-9416-045b3178fe6e/5b0461194f3092c033a6be518229e93b9b85e2db73c4e166e87c397ba9570f6e/email_thumbnail.jpg",
          "id": "...",
          "thumbnail": "https://motions.seen.io/2b183354-3aa3-4eda-9416-045b3178fe6e/5b0461194f3092c033a6be518229e93b9b85e2db73c4e166e87c397ba9570f6e/thumbnail.jpg"
        }
      ],
      "players": [
        {
          "id": "...",
          "link": "https://player.seen.io/v/eHmnkM2wqAWcgkQQmxPP"
        }
      ],
      "webhook": null
    }
  ],
  "values": {
    "country": "Norway",
    "first_name": "Daniel"
  }
}

404

In case the Data ID is not found in your project, you will receive a 404 Not Found response.

json
{
  "code": "ErrNotFound",
  "message": "item not found"
}

401

Upon an unauthorized request, you will receive a 401 Unauthorized response.

json
{
  "code": "ErrUnauthenticated",
  "message": "api key invalid"
}

429

Upon exceeding the rate limit, you will receive a 429 Too Many Requests response.

429 Too Many Requests

500

Upon a client error, you will receive a 500 Internal Server Error response.

json
{
  "code": "ErrClient",
  "message": "service unavailable"
}