# Get a hosted sign-in attempt
URL: https://musicapi.com/docs/reference/get-hosted-sign-in.md

`GET https://api.musicapi.com/app/integrations/{authModelUUID}`

Section: Connect your users.
Product: MusicAPI Core and MusicAPI Managed Transfers.
Auth: none.

The state of one sign-in attempt, as the hosted pages read it. The `authModelUUID` comes back in the callback. It needs no credentials and never returns `authData`.

## Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `authModelUUID` | uuid | yes |  |

## Response 200

OK

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `forwardFailures` | boolean | no |  |
| `authUrl` | string | yes | The music service's own sign-in URL for this login. |
| `returnUrl` | string | yes | Where the browser goes when the login ends. |
| `oneTimeToken` | string \| null | no |  |
| `authModel` | AuthModel | yes |  |
| `authModel.uuid` | uuid | yes |  |
| `authModel.status` | string | yes | One of: initialised, success, error. |
| `authModel.error` | string \| null | yes |  |
| `authModel.errorType` | string \| null | yes | One of: accessDenied, notAllowedInYourCountry, missingScopes, deniedSubscriptionTier, null. |
| `integrationUser` | UserResponse \| null | no |  |
| `integrationUser.uuid` | uuid | yes | The integrationUserUUID. Use it in every `/api/{integrationUserUUID}/...` call. |
| `integrationUser.integrationUserId` | string | yes | The user's id on the music service. |
| `integrationUser.name` | string \| null | yes |  |
| `integrationUser.email` | string \| null | yes |  |
| `integrationUser.imageUrl` | string \| null | yes |  |
| `integrationUser.country` | string \| null | yes | ISO 3166-1 alpha-2 country of the account, when the service tells us. |
| `user` | PublicPartner | yes |  |
| `user.id` | number | yes |  |
| `user.slug` | string | yes |  |
| `user.name` | string | yes |  |
| `user.logoFile` | object \| null | no |  |
| `user.base64Logo` | string \| null | no |  |
| `user.logoSquareFile` | object \| null | no |  |
| `integration` | PublicIntegration | yes | One music service that the partner turned on, with its public settings. |
| `integration.type` | string | yes |  |

```json
{
  "forwardFailures": true,
  "authUrl": "string",
  "returnUrl": "string",
  "oneTimeToken": "string",
  "authModel": {
    "uuid": "5b0c6f0e-2c8a-4d0e-9a51-7e3f1c2d9b44",
    "status": "initialised",
    "error": "string",
    "errorType": "accessDenied"
  },
  "integrationUser": {
    "uuid": "3f0b8c1e-6a4d-4c7a-9a55-2f1e7d9b0c11",
    "integrationUserId": "mica.nowak",
    "name": "Mica Nowak",
    "email": "mica@example.com",
    "imageUrl": "https://images.example.com/mica.jpg",
    "country": "PL"
  },
  "user": {
    "id": 0,
    "slug": "acme",
    "name": "Acme Music",
    "logoFile": {},
    "base64Logo": "string",
    "logoSquareFile": {}
  },
  "integration": {
    "type": "spotify"
  }
}
```

## Errors

- 404: No sign-in attempt with this uuid.

## Example

```bash
curl https://api.musicapi.com/app/integrations/{authModelUUID}
```