Retrieve a capability

Retrieve a specific capability that an account has requested. Read our capabilities guide to learn more.

To access this endpoint using an access token you’ll need to specify the /accounts/{accountID}/capabilities.read scope.

GET

/accounts/{accountID}/capabilities/{capabilityID}

cURL Go

1
2


curl -X GET "https://api.moov.io/accounts/{accountID}/capabilities/{capabilityID}" \
  -H "Authorization: Bearer {token}" \

1
2
3
4
5
6


mc, _ := moov.NewClient()

var accountID string
var capabilityID = moov.CapabilityName_Transfers

mc.GetCapability(ctx, accountID, capabilityID)

200 401 403 404 429 500 504

The request completed successfully.

{
  "accountID": "3dfff852-927d-47e8-822c-2fffc57ff6b9",
  "capability": "transfers",
  "createdOn": "2019-08-24T14:15:22Z",
  "disabledOn": "2019-08-24T14:15:22Z",
  "disabledReason": "string",
  "requirements": {
    "currentlyDue": [
      "account.tos-acceptance"
    ],
    "errors": [
      {
        "errorCode": "invalid-value",
        "requirement": "account.tos-acceptance"
      }
    ]
  },
  "status": "enabled",
  "updatedOn": "2019-08-24T14:15:22Z"
}

x-request-id


      string
      <uuid>

required

A unique identifier used to trace requests.

The request contained missing or expired authentication.

x-request-id


      string
      <uuid>

required

A unique identifier used to trace requests.

The user is not authorized to make the request.

x-request-id


      string
      <uuid>

required

A unique identifier used to trace requests.

The requested resource was not found.

x-request-id


      string
      <uuid>

required

A unique identifier used to trace requests.

Request was refused due to rate limiting.

x-request-id


      string
      <uuid>

required

A unique identifier used to trace requests.

The request failed due to an unexpected error.

x-request-id


      string
      <uuid>

required

A unique identifier used to trace requests.

The request failed because a downstream service failed to respond.

x-request-id


      string
      <uuid>

required

A unique identifier used to trace requests.

Headers

x-moov-version


      string

API version

Specify an API version.

API versioning follows the format vYYYY.QQ.BB, where

YYYY is the year
QQ is the two-digit month for the first month of the quarter (e.g., 01, 04, 07, 10)
BB is the build number, starting at .01, for subsequent builds in the same quarter.
- For example, v2024.01.00 is the initial release of the first quarter of 2024.

The latest version represents the most recent development state. It may include breaking changes and should be treated as a beta release.

Default: v2024.01.00

Path parameters

accountID


      string
      <uuid>

required

capabilityID


      string

required

Possible values: transfers, send-funds, collect-funds, wallet, card-issuing, production-app

Response

application/json

accountID


        string<uuid>

required

capability


        string<enum>

required

Moov account capabilities.

The production-app capability might appear in your list. This is a read-only capability that Moov requests and uses for account verification purposes. The capability remains active with your account and requires no additional action.

Possible values: transfers, send-funds, collect-funds, wallet, card-issuing

createdOn


        string<date-time>

required

status


        string<enum>

required

The status of the capability requested for an account.

Possible values: enabled, disabled, pending, in-review

updatedOn


        string<date-time>

required

disabledOn


        string<date-time>

disabledReason


        string

requirements


        object

Represents individual and business data necessary to facilitate the enabling of a capability for an account.

Show child attributes

currentlyDue


        array

Possible values: account.tos-acceptance, individual.mobile, individual.email, individual.email-or-mobile, individual.firstname, individual.lastname, individual.address, individual.ssn-last4, individual.ssn, individual.birthdate, business.legalname, business.description-or-website, business.entity-type, business.business-type, business.dba, business.ein, business.address, business.phone, business.admins, business.controllers, business.owners, business.classification, business.industry-code-mcc, business.indicate-owners-provided, business.average-transaction-size, business.max-transaction-size, business.average-monthly-transaction-volume, business.volume-by-customer-type, business.card-volume-distribution, business.fulfillment, business.description, business.underwriting-documents-tier-one, bank-accounts.name, bank-accounts.routing-number, bank-accounts.account-number, document.business.verification, document.individual.tin, document.individual.verification, document.representative.{rep-uuid}.tin, document.representative.{rep-uuid}.verification, representative.{rep-uuid}.mobile, representative.{rep-uuid}.email, representative.{rep-uuid}.email-or-mobile, representative.{rep-uuid}.firstname, representative.{rep-uuid}.lastname, representative.{rep-uuid}.address, representative.{rep-uuid}.ssn-last4, representative.{rep-uuid}.ssn, representative.{rep-uuid}.birthdate, representative.{rep-uuid}.job-title, representative.{rep-uuid}.is-controller, representative.{rep-uuid}.is-owner, representative.{rep-uuid}.ownership, document.{doc-uuid}

errors


        array

Show child attributes

errorCode


        string<enum>

Possible values: invalid-value, failed-automatic-verification, failed-other, invalid-address, address-restricted, tax-id-mismatch, document-id-mismatch, document-date-of-birth-mismatch, document-name-mismatch, document-address.mismatch, document-number-mismatch, document-incomplete, document-failed-risk, document-illegible, document-unsupported, document-not-uploaded, document-corrupt, document-expired

requirement


        string<enum>

The unique ID of what the requirement is asking to be filled out.

Possible values: account.tos-acceptance, individual.mobile, individual.email, individual.email-or-mobile, individual.firstname, individual.lastname, individual.address, individual.ssn-last4, individual.ssn, individual.birthdate, business.legalname, business.description-or-website, business.entity-type, business.business-type, business.dba, business.ein, business.address, business.phone, business.admins, business.controllers, business.owners, business.classification, business.industry-code-mcc, business.indicate-owners-provided, business.average-transaction-size, business.max-transaction-size, business.average-monthly-transaction-volume, business.volume-by-customer-type, business.card-volume-distribution, business.fulfillment, business.description, business.underwriting-documents-tier-one, bank-accounts.name, bank-accounts.routing-number, bank-accounts.account-number, document.business.verification, document.individual.tin, document.individual.verification, document.representative.{rep-uuid}.tin, document.representative.{rep-uuid}.verification, representative.{rep-uuid}.mobile, representative.{rep-uuid}.email, representative.{rep-uuid}.email-or-mobile, representative.{rep-uuid}.firstname, representative.{rep-uuid}.lastname, representative.{rep-uuid}.address, representative.{rep-uuid}.ssn-last4, representative.{rep-uuid}.ssn, representative.{rep-uuid}.birthdate, representative.{rep-uuid}.job-title, representative.{rep-uuid}.is-controller, representative.{rep-uuid}.is-owner, representative.{rep-uuid}.ownership, document.{doc-uuid}

cURL Go

1
2


curl -X GET "https://api.moov.io/accounts/{accountID}/capabilities/{capabilityID}" \
  -H "Authorization: Bearer {token}" \

1
2
3
4
5
6


mc, _ := moov.NewClient()

var accountID string
var capabilityID = moov.CapabilityName_Transfers

mc.GetCapability(ctx, accountID, capabilityID)

200 401 403 404 429 500 504

The request completed successfully.

{
  "accountID": "3dfff852-927d-47e8-822c-2fffc57ff6b9",
  "capability": "transfers",
  "createdOn": "2019-08-24T14:15:22Z",
  "disabledOn": "2019-08-24T14:15:22Z",
  "disabledReason": "string",
  "requirements": {
    "currentlyDue": [
      "account.tos-acceptance"
    ],
    "errors": [
      {
        "errorCode": "invalid-value",
        "requirement": "account.tos-acceptance"
      }
    ]
  },
  "status": "enabled",
  "updatedOn": "2019-08-24T14:15:22Z"
}

x-request-id


      string
      <uuid>

required

A unique identifier used to trace requests.

The request contained missing or expired authentication.

x-request-id


      string
      <uuid>

required

A unique identifier used to trace requests.

The user is not authorized to make the request.

x-request-id


      string
      <uuid>

required

A unique identifier used to trace requests.

The requested resource was not found.

x-request-id


      string
      <uuid>

required

A unique identifier used to trace requests.

Request was refused due to rate limiting.

x-request-id


      string
      <uuid>

required

A unique identifier used to trace requests.

The request failed due to an unexpected error.

x-request-id


      string
      <uuid>

required

A unique identifier used to trace requests.

The request failed because a downstream service failed to respond.

x-request-id


      string
      <uuid>

required

A unique identifier used to trace requests.