# Get Sources

`GET /api/v1/data/sources`

Retrieves the source reference-data options. When `metric` is supplied, the result is narrowed to the sources valid for that metric. Requires the `read` ability.

## Query parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `metric` | string | no | Optional metric key to scope the returned sources. |

## Example request

```bash
curl "https://app.franchisesee.com/api/v1/data/sources" \
  -H "Authorization: Bearer $FRANCHISESEE_TOKEN" \
  -H "Accept: application/json"
```

## Responses

### 200 Success

```json
{
    "data": [
        {
            "value": "net_sales_amount",
            "label": "Net sales"
        }
    ]
}
```

### 401 Authentication failed or missing.

```json
{
    "message": "Unauthenticated."
}
```

### 403 The token lacks the required ability or the caller is not permitted.

```json
{
    "message": "This API token does not have the 'create' ability."
}
```
