Get Points

Retrieve points, optionally filtered by organization ID, symbol, or name

Overview

GET /v2/streams/points returns points. This is a public endpoint — no API key is required.

Use orgId to narrow results to a specific organization. This endpoint is useful when your integration supports point-based streams and needs to list the point assets available for stream creation or reporting.

If your organization only creates token-based streams with rewardToken, you do not need to call this endpoint.

Endpoint

curl

curl -X GET "https://earn.turtle.xyz/v2/streams/points?symbol=PTS"

const response = await fetch(
  'https://earn.turtle.xyz/v2/streams/points?symbol=PTS'
);

const data = await response.json();

Query Parameters

id · uuid

Optional point identifier.

orgId · uuid

Optional organization identifier. When provided, returns only points belonging to that organization.

symbol · string

Optional point symbol filter.

name · string

Optional point name filter.

Response Example

{
  "points": [
    {
      "id": "7ff13cf6-53d0-4f3e-bd1a-e8eab6db4cf1",
      "orgId": "9f51b66a-d13a-4b55-8515-ae6e4ef7cf25",
      "symbol": "PTS",
      "name": "Partner Points",
      "decimals": 18,
      "logoUrl": "https://cdn.example.com/points/pts.png",
      "createdAt": "2026-03-01T00:00:00Z",
      "updatedAt": "2026-03-01T00:00:00Z"
    }
  ]
}

Response Fields

points · Point[]

Array of points matching the provided filters.

See Create Point for the full Point schema.

Important Notes

Points are only relevant for point-based streams

Points are used when creating streams that use pointId as the reward source. They are not required for streams that use rewardToken.

Filters are optional and combinable

You can query by id, orgId, symbol, name, or any combination supported by your integration needs.

Error Handling

Unexpected internal error

Status Code: 500 Internal Server Error

Solution: Retry the request and contact Turtle if the issue persists.