Get an Account

GET 
/v2/accounts/:accountID

View a specific account contained within your store

Request

Path Parameters

accountID stringrequired

The ID of the account you want to retrieve.

Responses

200

OK

application/json

Schema

Schema

data object

type stringrequired

Default value: account

Specifies the the type of object. Set this value to account.

name stringrequired

Specifies the name of the account.

legal_name stringrequired

Specifies the legal name of the account.

registration_id string

Specifies the registration ID. If specified, this field is checked for uniqueness.

external_ref string

The unique attribute associated with the account. For example, this could be an external reference from a separate company system. The maximum length is 2048 characters. Default is null.

id UUID (string)

The unique identifier for an Account.

meta object

Additional information for this realm. For more information, see The meta object section.

timestamps object

created_at string

The date the account is created.

updated_at string

The date the account is updated.

links object

self string

A URL to the specific resource.

Example (from schema)

{
  "data": {
    "type": "account",
    "name": "acc-name",
    "legal_name": "acc-legal-name",
    "registration_id": "reg-id",
    "external_ref": "ext-ref",
    "id": "deb6b25f-8451-4211-9a22-95610333df23",
    "meta": {
      "timestamps": {
        "created_at": "2021-02-23T09:40:33.882Z",
        "updated_at": "2021-02-23T09:40:33.882Z"
      }
    },
    "links": {
      "self": "https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23"
    }
  }
}

404

Not Found

application/json

Schema

Schema

errors Error[]required
Array [
title stringrequired
A brief summary of the error.
status stringrequired
The HTTP response code of the error.
detail string
Optional additional detail about the error.
]

Example (from schema)

{
  "errors": [
    {
      "title": "string",
      "status": "string",
      "detail": "string"
    }
  ]
}

not-found-error

{
  "errors": [
    {
      "title": "Not Found",
      "status": "404",
      "detail": "account not found"
    }
  ]
}

default

Internal server error.

application/json

Schema

Schema

errors Error[]required
Array [
title stringrequired
A brief summary of the error.
status stringrequired
The HTTP response code of the error.
detail string
Optional additional detail about the error.
]

Example (from schema)

{
  "errors": [
    {
      "title": "string",
      "status": "string",
      "detail": "string"
    }
  ]
}

internal-server-error

Internal server error

{
  "errors": [
    {
      "title": "Internal Server Error",
      "status": "500",
      "detail": "there was a problem processing your request"
    }
  ]
}

Loading...