---
title: "Posições de uma conta de investimento"
method: GET
path: "/api/v1/investments/positions"
tags: ["Investimentos"]
---

# Posições de uma conta de investimento

`GET /api/v1/investments/positions`

## Request

- Base URL: `https://snabber.com.br`
- URL: `https://snabber.com.br/api/v1/investments/positions`
- Auth: HTTP bearer

Retorna as posições/contratos (`investment_positions`) de uma conta de investimento do workspace vinculado à chave de API — CDB, ações, fundos etc., com saldo, taxas e datas. `from`/`to` filtram por purchase_date/position_date. A conta precisa pertencer a esse workspace.

## Query parameters

- `workspace_id` integer
- `account_id` integer, required
- `from` string, date
- `to` string, date

## Response `200`

Lista de posições de investimento

- InvestmentPositionList
  - `data` InvestmentPosition[]
    - `id` integer
    - `name` string, nullable
    - `code` string, nullable
    - `type` string, nullable
    - `subtype` string, nullable
    - `status` string, nullable
    - `amount_original` number, nullable
    - `amount_withdrawal` number, nullable
    - `amount_profit` number, nullable
    - `balance` number, nullable
    - `position_date` string, date, nullable
    - `purchase_date` string, date, nullable
    - `due_date` string, date, nullable
    - `rate` number, nullable
    - `rate_type` string, nullable
    - `fixed_annual_rate` number, nullable
    - `annual_rate` number, nullable
    - `issuer` string, nullable
    - `currency_code` string
    - `updated_at` string, date-time
    - `closed_at` string, date-time, nullable: null = posição ainda aberta
    - `ignored` boolean: true se marcada manualmente como ignorada nos cálculos de rentabilidade
  - `meta` object
    - `workspace_id` integer
    - `account_id` integer

## Other responses

- `400`: Parâmetro inválido
- `401`: Chave de API ausente, inválida, revogada ou expirada
- `403`: Plano do usuário não tem acesso à API (downgrade para free)
- `404`: Conta não encontrada neste workspace
- `429`: Limite de requisições excedido

---

[API](https://skmtc.dev/snabber/apis/snabber-api.md) · [All operations](https://skmtc.dev/snabber/apis/snabber-api/llms.txt) · [OpenAPI document](https://skmtc.dev/snabber/apis/snabber-api/revisions/bf5841cbd8ce?raw)