Blockstream Enterprise
ReferenceAPI ReferenceUsers

List Users

List Users.

Request

UsersListRequest
interface UsersListRequest {
  action: 'get'
  resource: '/users'
  details?: {
    limit: number | undefined
    offset: number | undefined
    sort_by: 'created_at' | 'updated_at' | undefined
    sort: 'asc' | 'desc' | undefined
    filters: {
      first_name: string | undefined
      last_name: string | undefined
      email: string | undefined
      group_name: string | undefined
    } | undefined
  } | undefined
}

Prop

Type

Response

UsersListResponse_success
interface UsersListResponse_success {
  status: 'success'
  error_code?: '-1' | '-2' | '-3' | '-4' | '-5' | '-6' | '-7' | '-8' | '-9' | '-10' | '-11' | '-12' | '-13' | undefined
  message?: string | undefined
  details: {
    uid: string
    device_uuid: string | undefined
    server_ecdsa_pubkey: string | undefined
    server_rsa_pubkey: string | undefined
    email: string
    first_name: string | undefined
    last_name: string | undefined
    mobile: string | undefined
    roles: string[] | undefined
    ecdsa_pubkey: string
    rsa_pubkey: string
    created_at: string
    created_by: string
    updated_at: string
    updated_by: string
    groups: string[] | undefined
    wallets: string[] | undefined
    signers: string[] | undefined
    type: 'api' | 'regular'
  } []
  metadata: {
    total_count: number
  }
}

Prop

Type

UsersListResponse_failed | pending | unauthorized | rejected
interface UsersListResponse_failed | pending | unauthorized | rejected {
  status: 'failed' | 'pending' | 'unauthorized' | 'rejected'
  error_code?: '-1' | '-2' | '-3' | '-4' | '-5' | '-6' | '-7' | '-8' | '-9' | '-10' | '-11' | '-12' | '-13' | undefined
  message?: string | undefined
}

Prop

Type

Example

Example
import { resourceSchema } from '@blockstream/ecs-js-sdk'
import { broadcastRequest } from './broadcaster'

const response = await broadcastRequest<
  typeof resourceSchema.shape.users.shape.list
>(
  {
    action: 'get',
    resource: '/users',
    details: {
      // TODO: fill in required fields
    },
  },
  blockstream,
)

On this page