---
title: "Get Account"
method: GET
path: "/v2/accounts/{account_id}"
tags: ["Accounts"]
---

# Get Account

`GET /v2/accounts/{account_id}`

## Request

- Base URL: `https://api.paymongo.com`
- URL: `https://api.paymongo.com/v2/accounts/{account_id}`
- Auth: HTTP basic

Retrieve account details by account ID.
Only the account itself or its parent account can access the data.

## Path parameters

- `account_id` string, required

## Response `200`

Account retrieved successfully

- AccountResponse
  - `data` Account
    - `id` string: Unique identifier for the account
    - `type` 'consumer' | 'merchant': Account type
    - `activation_status` 'activated' | 'declined' | 'pending' | 'under_review': Account activation status
    - `person` Person
      - `type` 'owner' | 'representative': Person type
      - `first_name` string, nullable: User's first name
      - `last_name` string, nullable: User's last name
      - `middle_name` string, nullable: User's middle name
      - `mobile_number` string, nullable: Mobile number of the account holder. Must be a valid phone number starting with a country code followed by 4 to 15 digits (e.g., +639111111111)
      - `email_address` string, nullable: Email address of the account holder. Must be a unique email not associated with any existing PayMongo account
      - `date_of_birth` DateObject, nullable: Date represented as day, month, year
        - `day` integer, nullable: Day of month
        - `month` integer, nullable: Month (1-12)
        - `year` integer, nullable: Year. The account holder must be of legal age
      - `nationality` string, nullable: Nationality of the account holder. Represented by a 3-letter ISO code (e.g., PHL for the Philippines)
      - `nature_of_work` 'employed_locally' | 'retired' | 'pensioner' | 'ofw' | 'ofw_beneficiary' | 'student' | 'self_employed' | 'unemployed_spouse_income' | 'unemployed_other_income', nullable: Nature of work of the account holder
      - `place_of_birth` PlaceOfBirth, nullable: Place of birth
        - `city` string, nullable: City of birth
        - `country` string, nullable: Country code (ISO 3166-1 alpha-2)
      - `source_of_funds` 'allowance' | 'commission' | 'donation' | 'other' | 'pension' | 'salary', nullable: Source of funds of the representative.
      - `source_of_funds_other` string, nullable: Required if source_of_funds is set to other. Accepts a string value stating the name of the representative's business.
      - `source_of_funds_salary` string, nullable: Required if source_of_funds is set to salary. Accepts a string value stating the name of the representative's employer.
      - `tin` string, nullable: Tax Identification Number (TIN) of the account holder
      - `address` Address
        - `line1` string, nullable: Street address line 1
        - `line2` string, nullable: Street address line 2
        - `city` string, nullable: City
        - `state` string, nullable: State or province
        - `country` string, nullable: Country code (ISO 3166-1 alpha-2)
        - `postal_code` string, nullable: Postal or ZIP code
      - `permanent_address` Address
        - `line1` string, nullable: Street address line 1
        - `line2` string, nullable: Street address line 2
        - `city` string, nullable: City
        - `state` string, nullable: State or province
        - `country` string, nullable: Country code (ISO 3166-1 alpha-2)
        - `postal_code` string, nullable: Postal or ZIP code
      - `identity_verification_status` 'pending' | 'processing' | 'for_review' | 'passed' | 'passed_attestation_form' | 'passed_kyc_reliance' | 'failed': Identity verification status
    - `bank` Bank: Bank account information (merchant only)
      - `id` string, nullable: Unique ID of the bank account
      - `account_name` string, nullable: Bank account holder name
      - `account_number` string, nullable: Bank account number. This is a purely numeric value represented as a string
      - `bank_name` string, nullable: Bank name
    - `business` Business, nullable: Business information (merchant only)
      - `address` BusinessAddress: Business address
        - `line1` string, nullable: Street address line 1
        - `line2` string, nullable: Street address line 2
        - `city` string, nullable: City
        - `state` string, nullable: State or province
        - `country` string, nullable: Country code (ISO 3166-1 alpha-2)
        - `postal_code` string, nullable: Postal or ZIP code
      - `age` 'between_1_and_2_years' | 'between_2_and_5_years' | 'greater_than_5_years' | 'less_than_1_year', nullable: Age range of the business
      - `customer_service_number` string, nullable: Customer service contact number of the business. Must be a valid phone number starting with a country code followed by 4 to 15 digits (e.g., +639111111111)
      - `date_of_incorporation` DateObject, nullable: Date represented as day, month, year
        - `day` integer, nullable: Day of month
        - `month` integer, nullable: Month (1-12)
        - `year` integer, nullable: Year. The account holder must be of legal age
      - `description` string, nullable: Description of the business (max 255 characters)
      - `dti_registered_name` string, nullable: Registered name of the business with the Department of Trade and Industry (DTI)
      - `estimated_monthly_volume` 'less_than_100K' | 'between_100K_and_300K' | 'between_300K_and_500K' | 'between_500K_and_1M' | 'between_1M_and_3M' | 'greater_than_3M', nullable: Estimated monthly transaction volume range of the business in PHP. Required for account activation.
      - `handle` string, nullable: Unique handle or identifier for the business. Must be unique across all merchants. If left empty, automatically generated based on trade name
      - `industry` string, nullable: Merchant Category Code (MCC) for the business. See [MCC Reference](https://docs.paymongo.com/docs/account-settings-merchant-category-codes#sector-groups) for valid codes.
      - `legal_name` string, nullable: Legal name of the business. Follows specific rules depending on the business type
      - `physical_store` boolean, nullable: Whether the business has a physical store
      - `registration_number` string, nullable: Registration number of the business
      - `size` 'between_10_and_50' | 'between_51_and_250' | 'greater_than_250' | 'less_than_10', nullable: Size of the business in terms of number of employees
      - `tin` string, nullable: Business TIN
      - `trade_name` string, nullable: Trade name of the business. Must not consist solely of numbers, symbols, or spaces
      - `type` 'individual' | 'sole_proprietor' | 'partnership' | 'corporation', nullable: Registration type of the business
      - `website` string, nullable: Business website
    - `created_at` integer: Unix timestamp of creation
    - `updated_at` integer: Unix timestamp of last update

## Other responses

- `401`: Unauthorized
- `403`: Forbidden - not authorized to access this account
- `404`: Account not found
- `500`: Internal server error

---

[API](https://skmtc.dev/paymongo/apis/accounts-api.md) - [All operations](https://skmtc.dev/paymongo/apis/accounts-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paymongo/apis/accounts-api/revisions/68d0b0b08710?raw)