Retornar Transações

Retorna um array de transações Ouro Minas, ordenadas da mais recente para a mais antiga. Sem filtros, retorna as últimas 10 transações OM.

GETv1/om/transactions

Query Params

Propriedade	Tipo	Descrição
date_created	date-time	Filtro para Data de Criação.
date_updated	date-time	Filtro para Data de Atualização.
agent_terminal_id	string	Filtro por Id Terminal (PinPad).
status	string	Filtro por status. Valores: paid, refused, refunded, chargeback.
payment_method	string	Filtro por método. Valores: credit, debit.
item_id	string	Filtro pelo ID do item/request.
count	int32	Quantidade de resultados. Máximo 1.000, default 10.
page	int32	Página para paginação.

Tip

A propriedade date_created no endpoint transactions pode ser usada para filtrar buscas em ranges de data utilizando os prefixos:

Prefixo	Significado
<	menor que
>	maior que
<=	menor ou igual a
>=	maior ou igual a

Por exemplo, para buscar em um range de date_created:

Status Paid

Request

Atenção

A filtragem por data utiliza unixTimeStamp em milissegundos para representá-la. Para gerar o unixTimeStamp de uma data, é possível utilizar o console do Google Chrome com o seguinte código em Javascript: new Date("2021-05-04T00:00:00.000Z").getTime() que retornará 1620086400000.

Response Object

Objeto com total, page, offset e transactions. O array transactions segue a mesma estrutura de resposta da criação de transação (incluindo campos da adquirente e do cliente). Em transações com payment_method debit, o campo installments será "1" (à vista).

Exemplo

Últimas transações OM

Request

  curl GET https://api.om.marlim.co/v1/om/transactions
  --H "Content-Type": "application/json"
  --H "api_key": "api_key_value"
  --data-raw '{}'

Response

{
  "total": 50,
  "page": 1,
  "offset": 5,
  "transactions": [
    {
      "status": "paid",
      "authorization_code": "123456",
      "nsu": "11122233",
      "acquirer_response_code": "0000",
      "marlim_transaction_id": "11122233",
      "date_created": "2021-05-04T00:00:00.000Z",
      "date_updated": "2021-05-04T00:00:00.000Z",
      "payment_method": "credit",
      "installments": "3",
      "authorized_amount": 104221,
      "paid_amount": 104221,
      "paid_per_month": 26055,
      "interest_rate": 1.04,
      "interest_rate_per_month": 1407,
      "interest_rate_total": 4221,
      "card_last_digits": "4444",
      "card_first_digits": "5364"
    }
  ]
}

Filtro por data de criação

Request

  curl GET https://api.om.marlim.co/v1/om/transactions?date_created=%3E%3D1774396800000&date_created=%3C%3D1784396800000
  --H "Content-Type": "application/json"
  --H "api_key": "api_key_value"
  --data-raw '{}'

Response

{
  "total": 3,
  "page": 1,
  "offset": 1,
  "transactions": [
    {
      "status": "paid",
      "marlim_transaction_id": "11122233",
      "date_created": "2026-03-26T14:22:00.000Z",
      "date_updated": "2026-03-26T14:22:05.000Z",
      "payment_method": "credit",
      "installments": "1",
      "authorized_amount": 104800,
      "paid_amount": 104800
    }
  ]
}