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

# Get an action

> Fetch a single action awaiting endorsement by id.



## OpenAPI

````yaml /knowledge-base/openapi/v4.yaml get /endorsements/actions/{actionId}
openapi: 3.1.0
info:
  title: Anchorage Digital Account APIs (v4)
  version: 4.0.0-beta
  description: >-
    Reference for the Anchorage Digital v4 API, the surface behind Crypto as a
    Service: account management (accounts and the account tree, beneficiaries,
    freeze/unfreeze/close), balances and transactions, trusted destinations,
    orders and allocations, withdrawals, deposit instructions, deposit
    attributions, the policy engine (policies, approval keys), and supported
    asset types. Approval groups, endorsements, compliance profiles, customers
    (onboarding), fee configuration updates, interest enrollment, funding
    allocations, and destination removal are under construction and return
    mocked data only.


    Status: BETA. The v4 API is available in the sandbox only
    (https://api.anchorage-staging.com/v4) and is not available in production
    yet. The contract may change until general availability. Which endpoints are
    live, in final testing, or under construction:
    https://docs.anchorage.com/platform/developers/caas/caas-overview


    Authentication: every request carries an `Api-Access-Key` header. Every
    POST, PATCH, and DELETE additionally requires an `Idempotency-Key`, and is
    signed with `Api-Signature` (hex-encoded Ed25519 over
    `timestamp_epoch_seconds + uppercase(http_method) + request_path +
    request_body`) plus `Api-Timestamp` (unix epoch seconds).


    Pagination: list endpoints accept `after` (cursor) and `limit` (page size, 1
    to 1000, default 100) and return a `page.endCursor` to continue from. Errors
    use a common envelope with a human-readable `message`; batch endpoints
    return a result per item instead.


    Guides: https://docs.anchorage.com/platform/developers/caas/caas-overview
servers:
  - url: https://api.anchorage-staging.com/v4
security:
  - Api-Access-Key: []
tags:
  - name: Accounts
  - name: Compliance Profiles
  - name: Balances
  - name: Transactions
  - name: Trusted Destinations
  - name: Orders & Allocations
  - name: Withdrawals
  - name: Deposit Instructions
  - name: Deposit Attributions
  - name: Policies
  - name: Approval Groups
  - name: Endorsements
  - name: Customers
  - name: Asset Types
paths:
  /endorsements/actions/{actionId}:
    get:
      tags:
        - Endorsements
      summary: Get an action
      description: Fetch a single action awaiting endorsement by id.
      operationId: getAction
      parameters:
        - name: actionId
          in: path
          schema:
            type: string
            format: uuid
            example: 3486b413-93d3-4447-afce-2b9c9dc34a32
          required: true
          description: Unique identifier for the action awaiting endorsement
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionResponse'
        '401':
          description: Unauthenticated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
components:
  schemas:
    ActionResponse:
      title: Action Response
      type: object
      required:
        - data
      properties:
        data:
          $ref: '#/components/schemas/Action'
    ErrorDetails:
      title: ErrorDetails
      type: object
      properties:
        message:
          description: A human-readable message providing more details about the error.
          example: Missing required field 'amount'.
          type: string
      required:
        - message
    Action:
      title: Action
      type: object
      description: >-
        A change awaiting the endorsements its policy requires. Opened
        automatically by policy evaluation —

        never created directly by a client — and returned as action on the
        response from whichever API the

        change was submitted to.
      properties:
        id:
          type: string
          format: uuid
          example: 3486b413-93d3-4447-afce-2b9c9dc34a32
        resourceType:
          allOf:
            - $ref: '#/components/schemas/ResourceType'
          description: Which namespace resourceId belongs to.
        resourceId:
          description: >-
            The resource this action governs, in the resourceType namespace. For
            a creation action type —

            POLICY_CREATE, KEY_REGISTER, KEY_GROUP_CREATE — this is the id
            reserved for the resource being

            created: it does not exist yet, but the id is already minted and is
            the one it will carry if the

            action is endorsed. If the action is rejected or expires, that id is
            retired unused.
          type: string
          format: uuid
          example: 3486b413-93d3-4447-afce-2b9c9dc34a32
        subjectId:
          description: >-
            The object this action actually creates or acts on, when that
            differs from resourceId — for

            example a withdrawal, where resourceId names the account whose
            policy governs it. Always

            present: equal to resourceId when the governing and created resource
            are the same thing, as

            for POLICY_CREATE, KEY_REGISTER, and KEY_GROUP_CREATE.


            Equal to resourceId for `TRUSTED_DESTINATION_ADD` and
            `TRUSTED_DESTINATION_REMOVE` as well,

            where it names the account the destination is being added to or
            removed from. The destination

            itself is not identified here: an add is authorized before the
            destination exists, and neither

            action type carries a destination id. So an approver sees which
            account is changing, not which

            destination — if that becomes insufficient, the id has to reach the
            engine on the request

            first.
          type: string
          format: uuid
          example: 3486b413-93d3-4447-afce-2b9c9dc34a32
        actionType:
          allOf:
            - $ref: '#/components/schemas/ActionType'
          description: The action type that triggered this action.
        status:
          $ref: '#/components/schemas/ActionStatus'
        receivedEndorsements:
          type: array
          items:
            $ref: '#/components/schemas/ReceivedEndorsement'
          description: >-
            Every endorsement collected so far — which key, and which group it
            counted toward.
        submittedAt:
          type: string
          format: date-time
          example: '2019-01-02T12:34:56.000Z'
        expiresAt:
          description: >-
            When this action stops accepting endorsements and becomes EXPIRED.
            Derived from submittedAt plus

            the governing policy's requiredActions.settings.expiresIn, which
            defaults to 14 days when unset.

            Where several policies govern the same change, the shortest of their
            windows is the one applied.
          type: string
          format: date-time
          example: '2019-01-02T12:34:56.000Z'
    ResourceType:
      title: Resource Type
      type: string
      enum:
        - ACCOUNT
        - POLICY
        - KEY
        - APPROVAL_GROUP
      description: >-
        Which namespace a resource id belongs to, and which family of action
        types that resource

        participates in:


        * `ACCOUNT` — transaction action types (`WITHDRAWAL`, `DEPOSIT`) and
        trusted-destination
          action types (`TRUSTED_DESTINATION_ADD`, `TRUSTED_DESTINATION_REMOVE`). A trusted destination
          is added to or removed from an account, so such a policy scopes to an account, to any account
          above it, or to the organization — never to an individual destination.
        * `POLICY` — policy-governance action types (`POLICY_CREATE`,
        `POLICY_ARCHIVE`).

        * `KEY` — approval-key-governance action types (`KEY_REGISTER`,
        `KEY_ARCHIVE`).

        * `APPROVAL_GROUP` — approval-group-governance action types
        (`KEY_GROUP_CREATE`,
          `KEY_GROUP_ARCHIVE`).

        For the creation action types (`POLICY_CREATE`, `KEY_REGISTER`,
        `KEY_GROUP_CREATE`) there is no

        resource yet, so a policy's `resourceIds` are the root account ids it
        governs even though its

        `resourceType` names the family being created.
    ActionType:
      title: Action Type
      type: string
      enum:
        - WITHDRAWAL
        - DEPOSIT
        - TRUSTED_DESTINATION_ADD
        - TRUSTED_DESTINATION_REMOVE
        - POLICY_CREATE
        - POLICY_ARCHIVE
        - KEY_REGISTER
        - KEY_ARCHIVE
        - KEY_GROUP_CREATE
        - KEY_GROUP_ARCHIVE
    ActionStatus:
      title: Action Status
      type: string
      enum:
        - PENDING
        - ENDORSED
        - REJECTED
        - EXPIRED
      description: >-
        The action's own lifecycle, distinct from the status of the resource it
        governs. PENDING means it is still collecting endorsements.
    ReceivedEndorsement:
      title: Received Endorsement
      type: object
      properties:
        keyId:
          description: The key that endorsed.
          type: string
          format: uuid
          example: 3486b413-93d3-4447-afce-2b9c9dc34a32
        approvalGroupId:
          description: The approval group this endorsement counted toward.
          type: string
          format: uuid
          example: 3486b413-93d3-4447-afce-2b9c9dc34a32
        endorsedAt:
          type: string
          format: date-time
          example: '2019-01-02T12:34:56.000Z'
  securitySchemes:
    Api-Access-Key:
      type: apiKey
      name: Api-Access-Key
      in: header
      description: An API key associated with a security role

````

## Related topics

- [Get a policy](https://docs.anchorage.com/knowledge-base/api-reference/v4/policies/get-a-policy.md)
- [Getting started](https://docs.anchorage.com/knowledge-base/platform/developers/caas/caas-getting-started.md)
- [API Changelog](https://docs.anchorage.com/knowledge-base/porto/api-reference/changelog.md)
- [Get a settlement by ID](https://docs.anchorage.com/knowledge-base/porto/api-reference/v2/atlas-settlement-network/get-a-settlement-by-id.md)
