Retrieve an account
Retrieves details for the account with the specified ID.
To access this endpoint using an access token you'll need
to specify the /accounts/{accountID}/profile.read scope.
curl -X GET "https://api.moov.io/accounts/{accountID}" \
-H "Authorization: Bearer {token}" \
-H "X-Moov-Version: v2026.10.00"mc, _ := moov.NewClient()
var accountID string
mc.GetAccount(ctx, accountID)
import { Moov } from "@moovio/sdk";
const moov = new Moov({
security: {
username: "",
password: "",
},
});
async function run() {
const result = await moov.accounts.get({
accountID: "2f93a6cf-3b3b-4c17-8d3b-110dfadccea4",
});
console.log(result);
}
run();declare(strict_types=1);
require 'vendor/autoload.php';
use Moov\MoovPhp;
use Moov\MoovPhp\Models\Components;
$sdk = MoovPhp\Moov::builder()
->setSecurity(
new Components\Security(
username: '',
password: '',
)
)
->build();
$response = $sdk->accounts->get(
accountID: '2f93a6cf-3b3b-4c17-8d3b-110dfadccea4'
);
if ($response->account !== null) {
// handle response
}package hello.world;
import io.moov.sdk.Moov;
import io.moov.sdk.models.components.Security;
import io.moov.sdk.models.operations.GetAccountResponse;
import java.lang.Exception;
public class Application {
public static void main(String[] args) throws Exception {
Moov sdk = Moov.builder()
.security(Security.builder()
.username("")
.password("")
.build())
.build();
GetAccountResponse res = sdk.accounts().get()
.accountID("2f93a6cf-3b3b-4c17-8d3b-110dfadccea4")
.call();
if (res.account().isPresent()) {
System.out.println(res.account().get());
}
}
}from moovio_sdk import Moov
from moovio_sdk.models import components
with Moov(
security=components.Security(
username="",
password="",
),
) as moov:
res = moov.accounts.get(account_id="2f93a6cf-3b3b-4c17-8d3b-110dfadccea4")
# Handle response
print(res)require 'moov_ruby'
Models = ::Moov::Models
s = ::Moov::Client.new(
security: Models::Components::Security.new(
username: '',
password: ''
)
)
res = s.accounts.get(account_id: '2f93a6cf-3b3b-4c17-8d3b-110dfadccea4')
unless res.account.nil?
# handle response
endusing Moov.Sdk;
using Moov.Sdk.Models.Components;
var sdk = new MoovClient(security: new Security() {
Username = "",
Password = "",
});
var res = await sdk.Accounts.GetAsync(accountID: "2f93a6cf-3b3b-4c17-8d3b-110dfadccea4");
// handle response{
"mode": "sandbox",
"accountID": "53ca67ea-6fd3-423f-9544-ce2404159d33",
"accountType": "business",
"displayName": "Whole Body Fitness LLC",
"profile": {
"business": {
"legalBusinessName": "Whole Body Fitness LLC",
"ownersProvided": false
}
},
"verification": {
"verificationStatus": "unverified",
"status": "unverified"
},
"settings": {
"cardPayment": {
"statementDescriptor": "Whole Body Fitness LLC"
},
"achPayment": {
"companyName": "Whole Body Fitne"
}
},
"createdOn": "2024-12-16T17:55:20.557151867Z",
"updatedOn": "2024-12-16T17:55:20.557151867Z"
}Response headers
x-request-id
string
required
Response headers
x-request-id
string
required
Response headers
x-request-id
string
required
Response headers
x-request-id
string
required
Response headers
x-request-id
string
required
Response headers
x-request-id
string
required
Response headers
x-request-id
string
required
Headers
X-Moov-Version
string
v2026.08.00 uses v2026.07.00.
A malformed value, such as 2022, returns a 404 response.
v2026.10.00
Path parameters
accountID
string
required
Response
accountID
string
required
accountType
string<enum>
required
individual,
business,
guest
createdOn
string<date-time>
required
displayName
string
<=64 characters
required
mode
string<enum>
required
sandbox,
production
profile
object
required
Show child attributes
profile
business
object
Show child attributes
profile.business
legalBusinessName
string
<=64 characters
required
Pattern
ownersProvided
boolean
required
address
object
Show child attributes
profile.business.address
addressLine1
string
<=60 characters
required
Pattern
city
string
<=32 characters
required
Pattern
country
string
<=2 characters
required
postalCode
string
<=5 characters
required
stateOrProvince
string
<=2 characters
required
addressLine2
string
<=32 characters
Pattern
businessType
string<enum>
soleProprietorship,
unincorporatedAssociation,
trust,
publicCorporation,
privateCorporation,
llc,
partnership,
unincorporatedNonProfit,
incorporatedNonProfit,
governmentEntity
description
string
[10 to 100] characters
Pattern
doingBusinessAs
string
<=64 characters
Pattern
string<email>
<=255 characters
industry
string
industryCodes
object
Show child attributes
profile.business.industryCodes
mcc
string
4 characters
naics
string
[2 to 6] characters
sic
string
4 characters
phone
object
Show child attributes
profile.business.phone
countryCode
string
<=1 characters
number
string
<=10 characters
primaryRegulator
string<enum>
OCC,
FDIC,
NCUA,
FRB,
state-cu-regulator
representatives
array<object>
Show child attributes
profile.business.representatives[]
address
object
Show child attributes
profile.business.representatives[].address
addressLine1
string
<=60 characters
required
Pattern
city
string
<=32 characters
required
Pattern
country
string
<=2 characters
required
postalCode
string
<=5 characters
required
stateOrProvince
string
<=2 characters
required
addressLine2
string
<=32 characters
Pattern
birthDateProvided
boolean
createdOn
string<date-time>
disabledOn
string<date-time>
string<email>
<=255 characters
governmentIDProvided
boolean
name
object
Show child attributes
profile.business.representatives[].name
firstName
string
<=64 characters
required
Pattern
lastName
string
<=64 characters
required
Pattern
middleName
string
<=64 characters
Pattern
suffix
string
<=20 characters
Pattern
phone
object
Show child attributes
profile.business.representatives[].phone
countryCode
string
<=1 characters
number
string
<=10 characters
representativeID
string
responsibilities
object
Show child attributes
profile.business.representatives[].responsibilities
isController
boolean
isOwner
boolean
true, this field indicates that the individual has a business ownership stake of at least 25% in the
business. If the representative does not own at least 25% of the business, this field should be false.
jobTitle
string
<=64 characters
Pattern
ownershipPercentage
integer
isOwner is true).
updatedOn
string<date-time>
taxIDProvided
boolean
website
string<uri>
<=100 characters
guest
object
Show child attributes
profile.guest
name
string
<=64 characters
required
Pattern
string<email>
<=255 characters
phone
object
Show child attributes
profile.guest.phone
countryCode
string
<=1 characters
number
string
<=10 characters
individual
object
Show child attributes
profile.individual
name
object
required
Show child attributes
profile.individual.name
firstName
string
<=64 characters
required
Pattern
lastName
string
<=64 characters
required
Pattern
middleName
string
<=64 characters
Pattern
suffix
string
<=20 characters
Pattern
address
object
Show child attributes
profile.individual.address
addressLine1
string
<=60 characters
required
Pattern
city
string
<=32 characters
required
Pattern
country
string
<=2 characters
required
postalCode
string
<=5 characters
required
stateOrProvince
string
<=2 characters
required
addressLine2
string
<=32 characters
Pattern
birthDateProvided
boolean
string<email>
<=255 characters
governmentIDProvided
boolean
phone
object
Show child attributes
profile.individual.phone
countryCode
string
<=1 characters
number
string
<=10 characters
updatedOn
string<date-time>
required
verification
object
required
Show child attributes
verification
status
string<enum>
required
deprecated
unverified,
pending,
verified,
errored
details
string<enum>
deprecated
failedAutoVerify,
docDobMismatch,
docNameMismatch,
docAddressMismatch,
docNumberMismatch,
docIncomplete,
docFailedRisk,
potentialAccountSanctionsMatch,
potentialRepresentativeSanctionsMatch,
failedOther
documents
array<object>
Show child attributes
verification.documents[]
contentType
string
documentID
string
parseErrors
array<string>
type
string<enum>
driversLicense,
passport,
utilityBill,
bankStatement
uploadedAt
string<date-time>
verificationStatus
string<enum>
deprecated
unverified,
pending,
resubmit,
review,
verified,
failed
capabilities
array<object>
Show child attributes
capabilities[]
capability
string
status
string
customerSupport
object
Show child attributes
customerSupport
address
object
Show child attributes
customerSupport.address
addressLine1
string
<=60 characters
required
Pattern
city
string
<=32 characters
required
Pattern
country
string
<=2 characters
required
postalCode
string
<=5 characters
required
stateOrProvince
string
<=2 characters
required
addressLine2
string
<=32 characters
Pattern
string<email>
<=255 characters
phone
object
Show child attributes
customerSupport.phone
countryCode
string
<=1 characters
number
string
<=10 characters
website
string<uri>
disconnectedOn
string<date-time>
foreignID
string
<=64 characters
Pattern
metadata
object
settings
object
Show child attributes
settings
achPayment
object
Show child attributes
settings.achPayment
companyName
string
[1 to 16] characters
required
Pattern
cardPayment
object
Show child attributes
settings.cardPayment
statementDescriptor
string
[4 to 22] characters
Pattern
termsOfService
object
Show child attributes
termsOfService
acceptedDate
string<date-time>
required
acceptedIP
string
required