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

# Entitled FIUs

> Discover which fiuId values you're currently onboarded with.

List Entitled FIUs lets you discover which `fiuId` values you're currently onboarded
with, and allowed to use on [Consent Creation](./initiate-consent)'s `fiuIds` array.

## Endpoint

```
GET /finpro/transaction/fius?gatewayInstanceId=<string>
```

Base URL: provided to you at onboarding.

## Headers

| Header          | Description                             |
| --------------- | --------------------------------------- |
| `Authorization` | `Basic base64(client_id:client_secret)` |

## Query parameters

<ParamField query="gatewayInstanceId" type="string" required>
  Your onboarded gateway instance ID. Omitting it returns a 400 `INVALID_REQUEST`.
</ParamField>

There is no request body.

## Sample request

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://<base_url>/finpro/transaction/fius?gatewayInstanceId=<your_gateway_instance_id>' \
    --header 'Authorization: Basic <base64(client_id:client_secret)>'
  ```
</CodeGroup>

## Response

```jsonc theme={null}
{
  "status": "SUCCESS",
  "fiuIds": ["string"]   // every fiuId you're currently onboarded with
}
```

<Note>
  Read-only, no side effects — safe to call at any time, including before ever
  calling Consent Creation. Reflects your current onboarded-FIU set at call time,
  which can change without notice as FIUs are onboarded or offboarded on MoneyOne's
  side. Call this rather than assuming your own records are still accurate.
</Note>

## Error Codes

| Error Code        | HTTP status | Meaning                                                                                                                  |
| ----------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------ |
| `UNAUTHORIZED`    | 401         | `Authorization` header is missing, malformed, or the credentials don't match your onboarded `client_id`/`client_secret`. |
| `INVALID_REQUEST` | 400         | `gatewayInstanceId` query parameter is missing.                                                                          |

## Next step

Use the returned `fiuIds` on [Initiate Consent](./initiate-consent)'s `productMappings[].fiuIds`.