> ## 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 owned by the organization associated with the API key

<Note>
  All requests require an API key via the `X-API-Key` header.
  See [Authentication](/sdk/authentication/api-keys) for details.
</Note>

## Overview

`GET /v1/streams/points` returns the points that belong to the organization associated with the API key.

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/v1/streams/points?symbol=PTS" \
    -H "X-API-Key: pk_live_xxxxx"
  ```

  ```typescript TypeScript theme={null}
  const response = await fetch(
    'https://earn.turtle.xyz/v1/streams/points?symbol=PTS',
    {
      headers: { 'X-API-Key': process.env.TURTLE_SECRET_KEY! },
    }
  );

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

**Query Parameters**

<ParamField query="id" type="uuid">
  Optional point identifier.
</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 owned by the calling organization.
</ResponseField>

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

## Important Notes

<AccordionGroup>
  <Accordion title="All point queries are organization-scoped">
    This endpoint only returns points belonging to the organization associated with the API key.
  </Accordion>

  <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`, `symbol`, `name`, or any combination supported by your integration needs.
  </Accordion>
</AccordionGroup>

## Error Handling

<AccordionGroup>
  <Accordion title="Missing or invalid API key">
    **Status Code:** 401 Unauthorized

    ```json theme={null}
    {
      "error": "Invalid API key"
    }
    ```

    **Solution:** Pass a valid `X-API-Key` header belonging to an organization-scoped API key.
  </Accordion>

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

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