> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.
# List deadlines
> Returns a filtered page of deadlines.
These endpoints power deadline management in the **Console**. You can also call them directly to integrate deadlines into your own systems.
## OpenAPI
````yaml en/openapi/v3-current/reporter.yaml get /v1/deadlines
openapi: 3.1.0
info:
contact:
name: Discord community
url: https://discord.gg/DnhqKwkGv3
description: >-
This is OpenAPI documentation for Reporter. The unified reporter binary
serves the REST API (RUN_MODE=api) and/or the RabbitMQ report-generation
worker (RUN_MODE=worker); RUN_MODE=all runs both in one process for local
development. All REST endpoints documented here serve only when RUN_MODE=api
or all (port :4005); the worker (port :4006) exposes health/readyz only.
license:
name: Lerian Studio General License
title: Midaz Reporter API
version: 4.0.0
servers:
- url: http://localhost:4005
- url: https://localhost:4005
security:
- BearerAuth: []
tags:
- description: Generated report instances and their lifecycle.
name: Reports
- description: Reusable report definitions.
name: Templates
- description: Interactive construction of report templates.
name: Template Builder
- description: Scheduled report due-date tracking.
name: Deadlines
- description: Configured inputs that feed report data.
name: Data Sources
- description: Aggregated reporting metrics.
name: Metrics
- description: Published business event catalog and delivery policies.
name: Streaming
paths:
/v1/deadlines:
get:
tags:
- Deadlines
summary: List deadlines
description: Returns a filtered page of deadlines.
operationId: listDeadlines
parameters:
- description: Deadline status filter.
example: pending
explode: false
in: query
name: status
schema:
description: Deadline status filter.
enum:
- pending
- overdue
- delivered
type: string
- description: Maximum number of deadlines in the page.
example: 10
explode: false
in: query
name: limit
schema:
default: 10
description: Maximum number of deadlines in the page.
type: integer
- description: One-based page number.
example: 1
explode: false
in: query
name: page
schema:
default: 1
description: One-based page number.
type: integer
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/DeadlineListHumaBody'
description: OK
'400':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Detail'
description: Bad Request
'401':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Detail'
description: Unauthorized
'403':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Detail'
description: Forbidden
'500':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Detail'
description: Internal Server Error
components:
schemas:
DeadlineListHumaBody:
properties:
items:
description: Deadlines in the requested page.
examples:
- - active: true
color: '#FF5733'
createdAt: '2026-01-01T00:00:00Z'
description: Monthly regulatory compliance report
dueDate: '2026-07-31T00:00:00Z'
frequency: monthly
id: 00000000-0000-0000-0000-000000000001
name: Monthly Regulatory Report
notifyDaysBefore: 5
status: pending
type: regulatory
updatedAt: '2026-01-01T00:00:00Z'
items:
$ref: '#/components/schemas/Deadline'
type:
- array
- 'null'
limit:
description: Maximum number of deadlines in the page.
examples:
- 10
format: int64
type: integer
page:
description: Current one-based page number.
examples:
- 1
format: int64
type: integer
total:
description: Total number of deadlines matching the filters.
examples:
- 10
format: int64
type: integer
type: object
Detail:
properties:
code:
description: >-
Stable, machine-readable domain error code scoped to the emitting
service (format: -NNNN).
examples:
- ERR-0001
type: string
detail:
description: >-
A human-readable explanation specific to this occurrence of the
problem.
examples:
- Property foo is required but is missing.
type: string
errors:
description: Optional list of individual error details
examples:
- - location: body.templateId
message: expected string to match 'uuid' format
value: not-a-uuid
items:
$ref: '#/components/schemas/ErrorDetail'
type:
- array
- 'null'
instance:
description: >-
A URI reference that identifies the specific occurrence of the
problem.
examples:
- https://example.com/error-log/abc123
format: uri
type: string
status:
description: HTTP status code
examples:
- 400
format: int64
type: integer
title:
description: >-
A short, human-readable summary of the problem type. This value
should not change between occurrences of the error.
examples:
- Bad Request
type: string
type:
default: about:blank
description: A URI reference to human-readable documentation for the error.
examples:
- https://example.com/errors/example
format: uri
type: string
type: object
Deadline:
properties:
active:
description: Whether the deadline is active.
examples:
- true
type: boolean
color:
description: Hex color used to identify the deadline.
examples:
- '#FF5733'
type: string
createdAt:
description: Date and time when the deadline was created.
examples:
- '2026-01-01T00:00:00Z'
format: date-time
type: string
deliveredAt:
description: Date and time when the deadline was delivered.
examples:
- '2026-03-15T10:00:00Z'
format: date-time
type: string
description:
description: Optional deadline description.
examples:
- Monthly regulatory compliance report
type: string
dueDate:
description: Date and time when the deadline is due.
examples:
- '2026-03-31T23:59:59Z'
format: date-time
type: string
frequency:
description: Deadline recurrence frequency.
examples:
- monthly
type: string
id:
description: Unique deadline identifier.
examples:
- 00000000-0000-0000-0000-000000000000
type: string
monthsOfYear:
description: Months in which a semiannual or annual deadline occurs.
examples:
- - 1
- 6
items:
format: int64
type: integer
type:
- array
- 'null'
name:
description: Human-readable deadline name.
examples:
- Monthly Regulatory Report
type: string
notifyDaysBefore:
description: Days before the due date when notifications begin.
examples:
- 5
format: int64
type: integer
status:
description: Current derived deadline status.
examples:
- pending
type: string
templateId:
description: Template used to generate the report.
examples:
- 00000000-0000-0000-0000-000000000000
type: string
templateName:
description: Human-readable name of the associated template.
examples:
- Financial Template
type: string
type:
description: Deadline category.
examples:
- regulatory
type: string
updatedAt:
description: Date and time when the deadline was last updated.
examples:
- '2026-01-01T00:00:00Z'
format: date-time
type: string
type: object
ErrorDetail:
properties:
location:
description: >-
Where the error occurred, e.g. 'body.items[3].tags' or
'path.thing-id'
examples:
- body.templateId
type: string
message:
description: Error message text
examples:
- expected string to match 'uuid' format
type: string
value:
description: The value at the given location
examples:
- not-a-uuid
type: object
securitySchemes:
BearerAuth:
bearerFormat: JWT
description: JWT bearer token issued by the identity provider.
scheme: bearer
type: http
````