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

# Validate Token

> Confirm your API key is valid and retrieve associated company and user details.

<Badge color="yellow">Soon</Badge>

<Note>
  This endpoint is under development and not yet available in production. Contact [support@musique.app](mailto:support@musique.app) to be notified when it launches.
</Note>

Verifies that your `X-API-Key` is active and returns the company and user details associated with the token. Use this to confirm your integration setup is working correctly before making other requests.

## Request

```http theme={null}
GET /api/v1/integration/validate-token
X-API-Key: msk_prod_1234567890abcdef
```

## Response

```json theme={null}
{
  "valid": true,
  "company": {
    "id": 1,
    "name": "Acme Corp"
  },
  "user": {
    "id": 42,
    "email": "integration@acmecorp.com"
  }
}
```

| Field          | Type    | Description                             |
| -------------- | ------- | --------------------------------------- |
| `valid`        | boolean | Always `true` for a successful response |
| `company.id`   | integer | Your company's internal Musique ID      |
| `company.name` | string  | Your company's display name             |
| `user.id`      | integer | The user ID associated with this token  |
| `user.email`   | string  | The email address of the token owner    |

## Error Responses

| Status | Code             | Description                           |
| ------ | ---------------- | ------------------------------------- |
| `401`  | `invalid_token`  | Token is missing, invalid, or revoked |
| `500`  | `internal_error` | Unexpected server error               |