Source: https://datafa.st/docs/api/account/tracked-goals/list
Markdown source: https://datafa.st/docs/api/account/tracked-goals/list.md
Description: List goal names already tracked by the website.

# List tracked goals

`GET https://datafa.st/api/v1/admin/websites/{websiteId}/goals`

List goal names already tracked by the website.

## Request

### Authentication

- `dft_` account token with `settings:read`.


### Path parameters

| Parameter | Type | Description |
| --- | --- | --- |
| `websiteId` | string | Website ObjectId used by account tokens to choose which website to query or manage. Website ObjectId. The caller token must have access to this website. |

## Response

Returns a JSON object with `status` and endpoint-specific fields.

### Response fields

| Field | Type | Description |
| --- | --- | --- |
| `data[].name` | string | Human-readable name for the resource or event. The exact meaning depends on the endpoint. |
| `data[].total` | number | Total completions/events. |
| `data[].uv` | number | Unique visitors who completed the goal. |
| `data[].conversionRate` | number | Conversion rate for the goal. |
| `data[].eventType` | string | Goal event type. |

### Errors

Common errors include `400` for invalid input, `401` for missing or invalid tokens, `403` for missing permissions or website access, `404` for missing resources, and `500` for server errors.

## Code examples

### Example request

```bash
curl -X GET "https://datafa.st/api/v1/admin/websites/{websiteId}/goals" \
  -H "Authorization: Bearer dft_xxx"
```

### Success response

```json
{
  "status": "success",
  "data": [{
    "name": "signup",
    "total": 482,
    "uv": 391,
    "conversionRate": 0.081,
    "eventType": "custom"
  }]
}
```