> ## Documentation Index
> Fetch the complete documentation index at: https://docs.turtle.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<CodeGroup>
  ```bash curl theme={null}
  curl -X GET "https://earn.turtle.xyz/v2/streams/points?symbol=PTS"
  ```

  ```typescript TypeScript theme={null}
  const response = await fetch(
    'https://earn.turtle.xyz/v2/streams/points?symbol=PTS'
  );

  const data = await response.json();
  ```
</CodeGroup>

**Query Parameters**

<ParamField query="id" type="uuid">
  Optional point identifier.
</ParamField>

<ParamField query="orgId" type="uuid">
  Optional organization identifier. When provided, returns only points belonging to that organization.
</ParamField>

<ParamField query="symbol" type="string">
  Optional point symbol filter.
</ParamField>

<ParamField query="name" type="string">
  Optional point name filter.
</ParamField>

## Response Example

```json theme={null}
{
  "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

<ResponseField name="points" type="Point[]">
  Array of points matching the provided filters.
</ResponseField>

See [Create Point](/sdk/streams/create-point) for the full `Point` schema.

## Important Notes

<AccordionGroup>
  <Accordion title="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`.
  </Accordion>

  <Accordion title="Filters are optional and combinable">
    You can query by `id`, `orgId`, `symbol`, `name`, or any combination supported by your integration needs.
  </Accordion>
</AccordionGroup>

## Error Handling

<AccordionGroup>
  <Accordion title="Unexpected internal error">
    **Status Code:** 500 Internal Server Error

    **Solution:** Retry the request and contact Turtle if the issue persists.
  </Accordion>
</AccordionGroup>