---
title: "Get remaining users"
method: GET
path: "/v1/domains/{domainId}/intents/{intentId}/remaining-users"
tags: ["Intents"]
---

# Get remaining users

`GET /v1/domains/{domainId}/intents/{intentId}/remaining-users`

## Request

- Base URL: `https://docs.ripple.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.ripple.com/v1/domains/{domainId}/intents/{intentId}/remaining-users`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ripple/apis/ripple-custody-api/docs/v1/domains/:domainId/intents/:intentId/remaining-users/get.ts> (a function with typed inputs; its response is checked against the schema)

This API operation will return the remaining user IDs able to approve for the currently open step of the intent approval process.

## Path parameters

- `domainId` string, uuid, required
- `intentId` string, uuid, required

## Query parameters

- `users.lock` CoreLockStatus[]

## Response `200`

- CoreRemainingDomainUsers[]
  - `domainId` string, uuid, required
  - `users` string[], required

## Other responses

- `400`: Intent is not opened (IntentNotOpenedError)
- `401`: One of: Invalid JWT (InvalidJwtError); User not authorized (PermissionDeniedError)
- `404`: Entity or Domain not found (EntityNotFoundError)

---

[API](https://skmtc.dev/ripple/apis/ripple-custody-api.md) - [All operations](https://skmtc.dev/ripple/apis/ripple-custody-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ripple/apis/ripple-custody-api/revisions/c6f0ad6b70c0?raw)