> This page is for API, version 2026-01-01 (Stable) (default).
> For other versions, use one of these documentation indexes:
> - 2026-01-01 (Stable) (default): https://docs.deel.wtf/api/stable/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.deel.wtf/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.deel.wtf/_mcp/server.

# Get integration consent

GET https://api.letsdeel.com/rest/integrations/consent

Retrieves the OAuth consent that links the calling client application to the authenticated organization, together with the user who granted it. Use it to check which user authorized your integration for the organization.

Reference: https://docs.deel.wtf/api/reference/endpoints/integrations/get-integration-consent-v-2026-01-01

## Authentication

- `Authorization` header (bearer token, required) — ## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.deel.training/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)
- `Authorization` header (bearer token, required) — Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

## Servers

- `https://api.letsdeel.com/rest` (Production, default)
- `https://api-staging.letsdeel.com/rest` (Demo)

## Response

### 200

Successful operation.

- `data` (IntegrationsConsentGetResponsesContentApplicationJsonSchemaData, optional)

## Errors

### 400 Bad Request Error

Bad request. The request could not be processed.

- `errors` (IntegrationsConsentGetResponsesContentApplicationJsonSchemaErrors, required) — The error body returned by the endpoint, wrapped unchanged.
- `request` (IntegrationsConsentGetResponsesContentApplicationJsonSchemaRequest, required) — Details of the failed request.

### 401 Unauthorized Error

Operation failed.

- `request` (ApiErrorRequest, optional)
- `errors` (list of ApiError, optional)

### 403 Forbidden Error

Operation failed.

- `request` (ApiErrorRequest, optional)
- `errors` (list of ApiError, optional)

### 404 Not Found Error

Operation failed.

- `request` (ApiErrorRequest, optional)
- `errors` (list of ApiError, optional)

### 500 Internal Server Error

Operation failed.

- `request` (ApiErrorRequest, optional)
- `errors` (list of ApiError, optional)

## Types

### IntegrationsConsentGetResponsesContentApplicationJsonSchemaData

- `id` (string, optional) — Unique identifier for the consent.
- `scope` (string, optional) — Scope of the consent.
- `state` (string, optional) — State of the consent.
- `status` (string, optional) — Status of the consent.
- `user_id` (string, optional, nullable) — User ID associated with the consent.
- `client_id` (string, optional) — Client ID associated with the consent.
- `user_name` (string, optional, nullable) — User name associated with the consent.
- `created_at` (string, optional) — Creation date for the consent.
- `expires_at` (string, optional) — Expiration date for the consent.
- `profile_id` (string, optional, nullable) — Profile ID associated with the consent.
- `updated_at` (string, optional) — Update date for the consent.
- `user_email` (string, optional, nullable) — User email associated with the consent.
- `redirect_uri` (string, optional) — Redirect URI for the consent.
- `organization_id` (string, optional, nullable) — Organization ID associated with the consent.

### IntegrationsConsentGetResponsesContentApplicationJsonSchemaErrors

The error body returned by the endpoint, wrapped unchanged.

- `errors` (list of IntegrationsConsentGetResponsesContentApplicationJsonSchemaErrorsErrorsItems, required) — Errors that caused the request to fail.

### IntegrationsConsentGetResponsesContentApplicationJsonSchemaRequest

Details of the failed request.

- `url` (string, optional) — The relative URL of the failed request.
- `docs` (string, optional) — A link to the documentation for the requested resource, or "no match".
- `method` (string, optional) — The HTTP method of the failed request.
- `source` (string, optional) — The protocol of the failed request.
- `status` (double, optional) — The status code of the response.
- `api_req_id` (string, optional) — The request ID of the failed request.

### ApiErrorRequest

- `method` (string, optional) — The HTTP method of the failed request
- `url` (string, optional) — The relative URL of the failed request
- `status` (double, optional) — The status code of the response
- `api_req_id` (string, optional) — The request ID of the failed request
- `docs` (string, optional) — A link to the official documentation for the requested endpoint resource
- `source` (string, optional) — The source handler which produced the returned error
- `code` (double, optional) — The code of the source handler which produced the returned error

### ApiError

- `message` (string, optional) — A description of the returned error
- `path` (string, optional) — The JSON path where input validation failed

### IntegrationsConsentGetResponsesContentApplicationJsonSchemaErrorsErrorsItems

- `message` (string, required) — Error message describing what went wrong.
- `code` (string, optional) — Machine-readable error code, when available.

## Examples

**Response**

```json
{
  "data": {
    "id": "3f2b8c1e-6a4d-4e59-9b7a-1c2d3e4f5a6b",
    "scope": "contracts:read people:read",
    "state": "a1b2c3d4e5f6",
    "status": "ALLOWED",
    "user_id": "8d1f6a52-3c7e-4b90-a2d4-5e6f7a8b9c0d",
    "client_id": "c9e4d7a2-1b3f-4a68-8d5c-0f1e2d3c4b5a",
    "user_name": "Jane Doe",
    "created_at": "2025-03-14T09:26:53.000Z",
    "expires_at": "2026-03-14T09:26:53.000Z",
    "profile_id": "5b7c9d1e-2f3a-4c6b-8e0d-9a1b2c3d4e5f",
    "updated_at": "2025-03-14T09:26:53.000Z",
    "user_email": "jane.doe@example.com",
    "redirect_uri": "https://app.example.com/oauth/callback",
    "organization_id": "12345"
  }
}
```

**SDK Code**

```python
import requests

url = "https://api.letsdeel.com/rest/integrations/consent"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api.letsdeel.com/rest/integrations/consent';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.letsdeel.com/rest/integrations/consent"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.letsdeel.com/rest/integrations/consent")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.letsdeel.com/rest/integrations/consent")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.letsdeel.com/rest/integrations/consent', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.letsdeel.com/rest/integrations/consent");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.letsdeel.com/rest/integrations/consent")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```