Reference

Listar descontos

Devolve os descontos, ordenados por id. Não inclui os descontos de utilização única. Sem updated_since devolve todos (sincronização inicial); com updated_since só os alterados desde essa data. Requer o plano Enterprise e o scope catalog:read.

get/v1/discounts

Request

  • Base URL: https://api-public.mvf.pt
  • URL: https://api-public.mvf.pt/v1/discounts
  • Auth: HTTP bearer

Query parameters

updated_sincestring date-time
Example:2026-10-07T00:00:00Z

Só os registos alterados depois desta data (ISO 8601). Um valor sem fuso horário (ex: 2026-10-07T08:00:00) e uma data sem hora (ex: 2026-10-07) são interpretados como UTC. Recomendamos enviar sempre em UTC com Z (ex: 2026-10-07T08:00:00Z). Usa a hora de início da sincronização anterior menos uma margem de segurança (ver Sincronização de dados).

limitinteger

Número máximo de registos por página.

cursorstring

O next_cursor da página anterior.

Response

Uma página de descontos.

Example response

{
  "data": [
    {
      "id": "dsc_4",
      "name": "Desconto Estudante",
      "percentage": 10,
      "active": true,
      "updated_at": "2026-10-08T08:00:00.000Z"
    }
  ],
  "pagination": {
    "next_cursor": "eyJhZnRlciI6MTAwfQ"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.