> ## Documentation Index > Fetch the complete documentation index at: https://docs.anycrm.anyreach.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Accounts New to accounts? See the [Accounts guide](/concepts/accounts) for how accounts relate to contacts and deals. This page is the field-level technical reference. An account is a company. Deals and contacts both carry an `account_id` and roll up to it; deleting an account isn't exposed here — contacts and deals just have their `account_id` set to `null` at the database level if an account is ever removed some other way. Returns a page of the caller's organization's accounts, ordered alphabetically by name. This is a **bare JSON array with no total-count signal** — keep incrementing `offset` until a response comes back shorter than `limit`. `limit` defaults to `200` and is capped at `500` server-side regardless of what you pass. `search` does a case-insensitive substring match against `name` **or** `domain`. Characters that are meaningful in the underlying filter syntax are neutralized first, but not identically: parentheses are removed, while each comma is **replaced with a space**. Watch out for that substitution — `search=Acme, Inc` becomes the pattern `*Acme Inc*` with a doubled space, which matches nothing. Drop the comma yourself (`search=Acme Inc`) when the name you're searching for contains one. Only a fixed projection of columns is returned, not the full account row (see Response below). ### Auth Requires a CRM read [scope](/authentication#scopes) and an active organization on the token. Any of `contacts:read`, `deals:read`, `companies:read`, or `activities:read` qualifies, as does any `*:manage` scope — manage implies read. ### Response Array of account objects, each with only these fields: | Field | Type | Description | | -------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | `string` (uuid) | Primary key. | | `name` | `string` | Account name. | | `industry` | `string \| null` | One of the `AccountIndustry` values, or `null`. | | `health_score` | `integer \| null` | Denormalized copy of the latest health score (0–100), or `null` if never computed. See [Refresh Account Health](/api-reference/accounts/refresh-health). | | `domain` | `string \| null` | Primary domain. | ## OpenAPI ````yaml GET /accounts openapi: 3.1.0 info: title: anycrm-api version: 0.0.1 servers: [] security: [] tags: - name: Customer Intelligence description: >- Company research and ICP-fit scoring — create a research run, track its progress, and read back scored companies as leads. - name: Outreach description: >- The cold-email management console — domains, mailboxes, and campaigns — as a thin control plane over the SalesForge stack. - name: AnyCard description: >- Authenticated CRUD for AnyCard, the org's digital business-card / lead-capture product. - name: AnyCard Events description: >- Event-attribution analytics for AnyCard — which captured leads converted, broken down by source, owner, and deal. - name: AnyCard Share Links description: >- Unauthenticated endpoints reached by anyone who scans a QR code or opens a shared AnyCard link. - name: AI description: >- A streaming (SSE) AI chat endpoint with account-commit actions it can take on the caller's behalf. - name: Analytics Assistant description: >- The natural-language analytics assistant — a guarded text-to-SQL loop (SSE) that answers ad-hoc questions over the org's CRM data as a least-privilege, read-only database role. - name: Account Readiness description: >- Account Readiness Profiles — AI-scored signals on whether an account is ready for outreach or expansion, computed via a Temporal workflow. - name: Integrations description: >- Pipedream Connect — issuing connect tokens and managing the org's connected third-party accounts. - name: Feedback description: >- User-submitted platform feedback (bug reports, feature requests) — global, not scoped to one organization. - name: Public Media description: >- Unauthenticated image reads for publicly-embeddable assets (card photos, inline email images) — allowlisted by key shape; everything else in the storage bucket stays private. - name: Service Health description: Service liveness. paths: /accounts: get: tags: - Accounts summary: Get Accounts operationId: get_accounts_accounts_get parameters: - name: limit in: query required: false schema: type: integer description: >- Maximum number of accounts to return; capped at 500 server-side regardless of what's passed. default: 200 title: Limit description: >- Maximum number of accounts to return; capped at 500 server-side regardless of what's passed. - name: offset in: query required: false schema: type: integer description: Number of accounts to skip, for pagination. default: 0 title: Offset description: Number of accounts to skip, for pagination. - name: search in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Case-insensitive substring match against name or domain. Filter-syntax characters are neutralized first: parentheses are removed, and each comma is replaced with a space — so 'Acme, Inc' searches for 'Acme Inc' (doubled space) and matches nothing. Omit the comma. title: Search description: >- Case-insensitive substring match against name or domain. Filter-syntax characters are neutralized first: parentheses are removed, and each comma is replaced with a space — so 'Acme, Inc' searches for 'Acme Inc' (doubled space) and matches nothing. Omit the comma. responses: '200': description: Successful Response content: application/json: schema: {} '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: HTTPBearer: type: http scheme: bearer ````