Query dispatch targets

GET 
/nevisfido/token/dispatch/targets

This is a proprietary nevisFIDO API used to retrieve all dispatch targets associated with a given user, providing the client with the information needed to select a destination for token dispatch. A dispatch target represents a registered delivery channel — such as a mobile device or email address — and each entry in the response includes an identifier and a human-readable name. The username query parameter is required; the server returns 400 if it is absent. This endpoint is typically called before invoking the Token Service, allowing the client to present the user's registered devices and let them choose which one should receive the operation token.

Request

Query Parameters

username stringrequired

The username whose dispatch targets are to be retrieved. Required.

Header Parameters

headers objectrequired

Responses

200

OK The server retrieved the dispatch targets for the user.

application/json

Schema

Schema

dispatchTargets object[]
empty boolean
Array [
name string
id string
dispatcher string
]

Example (from schema)

{
  "dispatchTargets": [
    {
      "name": "string",
      "id": "string",
      "dispatcher": "string"
    }
  ]
}

400

Bad Request The username query parameter is missing or the payload is not properly formatted.

401

Unauthorized The request was not authorized. There is an invalid SecToken or unresolved username.

403

Forbidden The specified user was not found in the credential repository.

404

Not Found No dispatch target could be found.

405

Method Not Allowed The method of the received request was not GET.

406

Not Acceptable The Accept header is not properly set to application/json.

415

Unsupported Media Type The Content-Type header is not properly set to application/json;charset=UTF-8.

500

Internal Server Error The server could not process the request because of an unexpected error.

Loading...