> ## Documentation Index > Fetch the complete documentation index at: https://docs.base39.com.br/llms.txt > Use this file to discover all available pages before exploring further. # List tasks ## OpenAPI ````yaml /api-reference/openapi.json get /v2/tasks openapi: 3.1.0 info: title: Base39 API description: Base39 API version: 1.0.0 contact: name: Base39 Team url: https://base39.com.br email: suporte@base39.com.br termsOfService: https://base39.com.br/termos license: name: Proprietary url: https://base39.com.br/termos servers: - url: http://localhost:3000 description: Local - url: https://api.dev.base39.cloud description: Development - url: https://api.base39.com.br description: Production security: - OAuth2: [] tags: - name: pages description: Profiles and reports pages - name: pipelines description: Pipeline boards (kanban) of pages - name: blocks description: Blocks operations - name: search description: Search across content - name: targets description: Lookup targets via datasets - name: CognitoTriggers description: Cognito triggers paths: /v2/tasks: get: tags: - tasks summary: List tasks operationId: task_find_all parameters: - name: expand required: false in: query description: >- Comma-separated fields to expand. Supports selection with brackets (e.g., "createdBy,updatedBy" or "targets.company[icon,tradeName]"). schema: example: createdBy type: string - name: page_size required: false in: query description: Number of items to return per page schema: minimum: 1 maximum: 100 default: 20 example: 100 type: number - name: start_cursor required: false in: query description: >- Opaque cursor for pagination. Use the next_cursor from previous response. schema: example: >- eyJjcmVhdGVkX3RpbWUiOiIyMDI0LTExLTE1VDEwOjAwOjAwLjAwMFoiLCJpZCI6InBhZ2VfYWJjMTIzIn0= type: string - name: schedule required: false in: query schema: type: string enum: - listening - once - daily - weekly - monthly - name: status required: false in: query schema: type: string enum: - active - inactive - name: parent_company_id required: false in: query schema: type: string example: cmp_123 - name: filter required: false in: query schema: type: string example: base39 - name: action_type required: false in: query schema: type: string enum: - webhook - agent - name: webhook required: false in: query schema: type: string enum: - monitoring.lawsuits.new_process - monitoring.receita_federal.alteracoes - name: agent required: false in: query schema: type: string enum: - company_history - orbit_web responses: '200': description: Paginated list of tasks content: application/json: schema: type: object properties: object: type: string example: list results: type: array items: $ref: '#/components/schemas/TaskOutput' next_cursor: type: string nullable: true has_more: type: boolean type: type: string required: - object - results - has_more components: schemas: TaskOutput: type: object properties: object: type: string example: page description: Object type title: Object x-locale-pt-br-title: Objeto id: type: string example: p_abc123 description: Unique identifier title: ID x-locale-pt-br-title: ID createdAt: format: date-time type: string example: '2024-01-15T10:30:00.000Z' description: Creation timestamp title: Created at x-locale-pt-br-title: Criado em updatedAt: format: date-time type: string example: '2024-01-15T14:45:00.000Z' description: Last update timestamp title: Updated at x-locale-pt-br-title: Atualizado em createdBy: type: object example: object: user id: u_abc123 apiKeyId: bsk_abc123 description: Principal who created this object properties: object: type: string enum: - user - service_account example: user id: type: string example: u_abc123 apiKeyId: type: string example: bsk_abc123 title: Created by x-locale-pt-br-title: Criado por updatedBy: type: object example: object: user id: u_abc123 apiKeyId: bsk_abc123 description: Principal who last updated this object properties: object: type: string enum: - user - service_account - webhook - stream example: user id: type: string example: u_abc123 apiKeyId: type: string example: bsk_abc123 title: Updated by x-locale-pt-br-title: Atualizado por schedule: type: string enum: - listening - once - daily - weekly - monthly status: type: string enum: - active - inactive parent: oneOf: - $ref: '#/components/schemas/TaskParentCompanyIdDto' discriminator: propertyName: type mapping: company_id: $ref: '#/components/schemas/TaskParentCompanyIdDto' allOf: - $ref: '#/components/schemas/TaskParentCompanyIdDto' actions: type: array items: oneOf: - $ref: '#/components/schemas/TaskWebhookActionDto' - $ref: '#/components/schemas/TaskAgentActionDto' discriminator: propertyName: type mapping: webhook: $ref: '#/components/schemas/TaskWebhookActionDto' agent: $ref: '#/components/schemas/TaskAgentActionDto' displayName: type: string description: Task display name example: Base39 Tecnologia Ltda lastEventAt: type: string description: Timestamp of the most recent task event format: date-time nullable: true lastError: type: string description: Last error message from the task execution nullable: true required: - object - id - createdAt - updatedAt - schedule - status - parent - actions - displayName TaskParentCompanyIdDto: type: object properties: type: type: string enum: - company_id company_id: type: string description: Company identifier example: cmp_123 required: - type - company_id TaskWebhookActionDto: type: object properties: type: type: string enum: - webhook - agent example: webhook webhook: type: string enum: - monitoring.lawsuits.new_process - monitoring.receita_federal.alteracoes query: $ref: '#/components/schemas/TaskWebhookQueryDto' required: - type - webhook - query TaskAgentActionDto: type: object properties: type: type: string enum: - webhook - agent example: agent agent: type: string enum: - company_history - orbit_web example: company_history session_id: type: string description: Base39 session id created for this agent task run example: ses_123 required: - type - agent TaskWebhookQueryDto: type: object properties: primary: type: string description: Primary monitored term example: '12345678000190' secondary: description: Secondary monitored terms example: - Base39 - Base39 Tecnologia Ltda type: array items: type: string required: - primary securitySchemes: OAuth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://id.local.base39.cloud/oauth2/authorize tokenUrl: https://id.local.base39.cloud/oauth2/token scopes: profile: Read user profile email: Read user email openid: OpenID authentication description: OAuth2 Authorization Code flow ````