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

# Get Account

> Gets an account: a group of customers that belong to the same business. Look it up by its `account_id`, or by the `customer_id` of any customer linked to it. Accounts only organize customers — each customer keeps its own plans, billing and Stripe customer.

### Body Parameters

The account's ID, if one was set. Pass this or `customer_id`.

Look the account up through one of its customers. Pass this or `account_id`.

### Response

The account's ID, if you've set one. Autumn never generates it.

The account's name, if set.

Customers linked to the account, oldest link first.

**properties**

The customer's ID.

The customer's name.

The customer's email.

When the account was created, ms since epoch.

```json 200 theme={null}
{
  "id": "acme",
  "name": "Acme Corp",
  "customers": [
    {
      "id": "acme-us",
      "name": "Acme US",
      "email": "billing@acme.com"
    },
    {
      "id": "acme-eu",
      "name": "Acme EU",
      "email": "eu-billing@acme.com"
    }
  ],
  "created_at": 1781113864000
}
```


## OpenAPI

````yaml openapi POST /v1/accounts.get
openapi: 3.1.0
info:
  title: Autumn API
  version: 2.6.0
servers:
  - url: https://api.useautumn.com
    description: Production server
security:
  - secretKey: []
paths:
  /v1/accounts.get:
    post:
      tags:
        - accounts
      description: >-
        Gets an account: a group of customers that belong to the same business.
        Look it up by its `account_id`, or by the `customer_id` of any customer
        linked to it. Accounts only organize customers — each customer keeps its
        own plans, billing and Stripe customer.
      operationId: getAccount
      parameters:
        - name: x-api-version
          in: header
          required: true
          schema:
            type: string
            default: 2.6.0
          x-speakeasy-globals-hidden: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                account_id:
                  type: string
                  minLength: 1
                  maxLength: 256
                  pattern: ^[a-zA-Z0-9_\-.]+$
                  description: >-
                    The account's ID, if one was set. Pass this or
                    `customer_id`.
                customer_id:
                  $ref: '#/components/schemas/CustomerId'
                  description: >-
                    Look the account up through one of its customers. Pass this
                    or `account_id`.
              title: GetAccountParams
              examples:
                - customer_id: acme-us
            example:
              customer_id: acme-us
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: >-
                      The account's ID, if you've set one. Autumn never
                      generates it.
                  name:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: The account's name, if set.
                  customers:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: The customer's ID.
                        name:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: The customer's name.
                        email:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: The customer's email.
                      required:
                        - id
                        - name
                        - email
                    description: Customers linked to the account, oldest link first.
                  created_at:
                    type: number
                    description: When the account was created, ms since epoch.
                required:
                  - id
                  - name
                  - customers
                  - created_at
                title: Account
                examples:
                  - id: acme
                    name: Acme Corp
                    customers:
                      - id: acme-us
                        name: Acme US
                        email: billing@acme.com
                      - id: acme-eu
                        name: Acme EU
                        email: eu-billing@acme.com
                    created_at: 1781113864000
              example:
                id: acme
                name: Acme Corp
                customers:
                  - id: acme-us
                    name: Acme US
                    email: billing@acme.com
                  - id: acme-eu
                    name: Acme EU
                    email: eu-billing@acme.com
                created_at: 1781113864000
      x-codeSamples:
        - lang: typescript
          label: Typescript (SDK)
          source: |-
            import { Autumn } from 'autumn-js'

            const autumn = new Autumn()

            const result = await autumn.accounts.get({
              customerId: "acme-us",
            });
        - lang: python
          label: Python (SDK)
          source: |-
            from autumn_sdk import Autumn

            autumn = Autumn(secret_key="am_sk_test...")

            res = autumn.accounts.get(customer_id="acme-us")
components:
  schemas:
    CustomerId:
      type: string
      title: CustomerId
      description: Your unique identifier for the customer
  securitySchemes:
    secretKey:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.