Plans

Catálogo público de planes y cotización con cupones. Usado por la landing y el dashboard.

Base path: /plans·6 endpoints·Source: mosend-wb-backend/src/modules/plans/plans.controller.ts
GET/plans
público

Lista pública de planes activos con sus precios.

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/plans'
Response · 200
{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2026-05-01T03:42:18.123Z"
    }
  ],
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/plans/:slug
público

Detalle público de un plan por su slug.

Path params

  • slugstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/plans/<slug>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/plans/quote/:slug
bearer

Precio final con cupón aplicado (informativo, no cobra).

Path params

  • slugstringrequerido

Query params

  • currencystring
  • intervalstring
  • couponstring

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/plans/quote/<slug>' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2026-05-01T03:42:18.123Z"
    }
  ],
  "timestamp": "2026-05-01T03:42:18.123Z"
}
POST/plans/organizations/:orgId/preview-change
bearer

Previsualiza el efecto de un cambio de plan: prorrateo + cupón + saldo final.

Path params

  • orgIdstringrequerido

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/plans/organizations/a1b2c3d4-1234-5678-9abc-def012345678/preview-change' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
POST/plans/organizations/:orgId/cancel-subscription
bearer

Cancela la suscripción de pago. Baja el plan a free, mantiene los datos. No emite reembolsos por servicios ya prestados.

Path params

  • orgIdstringrequerido

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/plans/organizations/a1b2c3d4-1234-5678-9abc-def012345678/cancel-subscription' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
PATCH/plans/organizations/:orgId/plan
bearer

Cambia el plan de una organización (self-service: upgrade/downgrade).

Path params

  • orgIdstringrequerido

Respuestas

  • 200
curl -X PATCH 'https://api.mosend.dev/plans/organizations/a1b2c3d4-1234-5678-9abc-def012345678/plan' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}