# Get sign-in statuses
URL: https://musicapi.com/docs/reference/usage-auth-statuses.md

`GET https://api.musicapi.com/public/analytics/auth-statuses`

Section: Billing and usage.
Product: MusicAPI Core and MusicAPI Managed Transfers.
Auth: Basic, DocsSession (any one of them). Use Basic with your Client ID and Client Secret from your server only.

The sign-in requests in the range for each music service: how many sign-ins started, connected an account, or failed. Requires Client Secret authentication. Not billed.

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `startDate` | string | yes | The first day of the range (UTC), for example `2026-10-01`. The day counts. |
| `endDate` | string | yes | The last day of the range (UTC). The day counts, so `startDate` = `endDate` is one day. The range may hold at most 366 days, or 31 days for an `hourly` series. |
| `integrationType` | spotify \\| appleMusic \\| youtube \\| tidal \\| resso \\| boomplay \\| amazonMusic \\| deezer \\| pandora \\| soundCloud \\| youtubeMusic \\| napster \\| qobuz \\| qqMusic \\| yandexMusic \\| vkMusic \\| anghami \\| zvuk \\| gaana \\| jiosaavn \\| audiomack | no | Count only the requests for this music service. Leave it out for every service. |

## Response 200

By service; in a service, the most frequent status first.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | object[] | yes |  |
| `data[].integration_type` | string | yes | The music service. |
| `data[].status` | string | yes | `initialised`: a sign-in started. `success`: a sign-in connected an account. `error`: a sign-in step failed. One of: initialised, success, error. |
| `data[].count` | string | yes | Sign-in requests with this status. A decimal string, so a large count stays exact. |

```json
{
  "data": [
    {
      "integration_type": "string",
      "status": "initialised",
      "count": "string"
    }
  ]
}
```

## Errors

- 400: A date is missing or not valid, `endDate` is before `startDate`, or the range is too long.
- 401: The request has no credentials.
- 403: The request does not use Client Secret authentication.
- 429: Your account sent more calls this minute than its rate limit allows.

## Example

```bash
curl https://api.musicapi.com/public/analytics/auth-statuses \
  -u "$MUSICAPI_CLIENT_ID:$MUSICAPI_CLIENT_SECRET"
```