# Retrieve an API resource (/docs/apis/management/resources/FindApiResourceById)

`GET /resources/api_resources/{api_id}`

Retrieves detailed information for the specified API resource.

Base URL: `https://{tenant}.{region}.monocloud.com/api`, where `{tenant}`, `{region}` (one of us, eu, in) come from your tenant. Authentication: send your Management API key in the `X-API-KEY` header.

## Parameters

- `api_id` (path) (string, required) The unique identifier of the API resource.

## Response body

`200`, JSON. The API resource was retrieved successfully

Returns `ApiResource`.

- `id` (string, required) The unique identifier of the resource.
- `enabled` (boolean, required) Indicates whether the resource is enabled.
- `display_name` (string) Human-readable display name for the resource.
- `description` (string) Description that explains the purpose of the resource.
- `creation_time` (integer, required, date-time) Specifies the creation time of the resource (in Epoch).
- `last_updated` (integer, required, date-time) Specifies the last update time of the resource (in Epoch).
- `audience` (string, required) Audience value that will be included in issued access tokens for this API resource.
- `allow_multi_audience` (boolean, required) Default value for whether access tokens issued for this API resource may carry additional audiences beyond this resource. Used when no matching API access policy provides an override. ScaleX subscription required to allow multi-audience tokens.
- `allow_user_info_access` (boolean, required) Default value for whether access tokens issued for this API resource may include identity scopes, allowing them to be used with identity-related endpoints such as `UserInfo`. Used when no matching API access policy provides an override. ScaleX subscription required to allow UserInfo access.
- `access_token_type` (string, required) Default access token type for this API resource. Used when no matching API access policy provides an override. One of: `jwt`, `reference`.
- `access_token_lifetime` (integer, required, int32) Default access token lifetime (in seconds) for this API resource. Used when no matching API access policy provides an override.
- `bind_tokens_to_session` (boolean, required) Default value for whether access tokens issued for this API resource are bound to the user session, causing them to be revoked when the session ends. Used when no matching API access policy provides an override. ScaleX subscription required to use session binding.
- `include_jwt_id` (boolean, required) Determines whether access tokens issued for this API resource include a unique token identifier (jti). Recommended for auditing, correlation, and replay-detection.
- `user_claims` (string[], required) List of user claim types that will be embedded into access tokens issued for this API resource.

## Errors

- `401` Unauthorized
- `403` Forbidden
- `404` Not Found
  - `type` (string, required) A URI reference that identifies the error type. When accessed, it may provide human-readable documentation.
  - `title` (string, required) A short, human-readable summary of the error.
  - `status` (integer, required, int32) The HTTP status code associated with this error response.
  - `trace_id` (string, required) A unique identifier for the request, used for tracing and diagnostics.
  - `detail` (string) A human-readable explanation specific to this occurrence of the error.
  - `instance` (string) A URI reference that identifies the specific occurrence of the error.
- `422` Unprocessable Entity
  - `type` (string, required) A URI reference that identifies the error type. When accessed, it may provide human-readable documentation.
  - `title` (string, required) A short, human-readable summary of the error.
  - `status` (integer, required, int32) The HTTP status code associated with this error response.
  - `trace_id` (string, required) A unique identifier for the request, used for tracing and diagnostics.
  - `detail` (string) A human-readable explanation specific to this occurrence of the error.
  - `instance` (string) A URI reference that identifies the specific occurrence of the error.
  - `errors` (Record<string, string[]>, required) A key-value map of validation errors, where each key represents a request field and the value contains one or more messages describing why the request could not be processed.

## Example (MonoCloud .NET SDK)

```csharp
using MonoCloud.Management;
using MonoCloud.Management.Core.Base;

var apiClient = new MonoCloudManagementClient(new MonoCloudConfig("<your-domain>", "[[API-Key]]"));


var apiId = "n8TniSuy4WN9ROJYNwir6";


var result = await apiClient.Resources.FindApiResourceByIdAsync(apiId);
```

## Example (MonoCloud Javascript SDK)

```javascript
import { MonoCloudManagementClient } from '@monocloud/management';

const apiClient = MonoCloudManagementClient.init({ domain: '<your-domain>', apiKey: '[[API-Key]]' });

const apiId = 'n8TniSuy4WN9ROJYNwir6';

const result = apiClient.resources.findApiResourceById(apiId);
```