> ## Documentation Index > Fetch the complete documentation index at: https://juridiqsoftware.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Listar andamentos processuais > Sem lawSuitId: os andamentos novos do escritório, pela ordem de entrada (todos veem; só quem trata marca como lido). Com lawSuitId: todos os andamentos do processo, pela data do andamento. Filtros e totais como os de publicações. Aceita JWT ou o header `x-juridiq-api-key`; o usuário da chave precisa ver processos (403 sem a permissão). ## OpenAPI ````yaml https://api.juridiq.com.br/api-docs/client/openapi.json get /movements/ openapi: 3.1.0 info: title: Juridiq API — Documentação para Integradores description: >- API REST para integradores autenticados com chave (`x-juridiq-api-key`). ## Rate limit A API aberta limita **120 requisições a cada 60s por chave**. Ao exceder, a resposta é `429 Too Many Requests` com os headers `x-ratelimit-limit`, `x-ratelimit-remaining`, `x-ratelimit-reset` e `retry-after`. Respeite o `retry-after` antes de tentar de novo. Sincronizações em lote devem paginar e tratar 429 com backoff. version: 1.0.0 servers: - url: https://api.juridiq.com.br description: Production server security: - apiKeyAuth: [] tags: [] paths: /movements/: get: tags: - Movements summary: Listar andamentos processuais description: >- Sem lawSuitId: os andamentos novos do escritório, pela ordem de entrada (todos veem; só quem trata marca como lido). Com lawSuitId: todos os andamentos do processo, pela data do andamento. Filtros e totais como os de publicações. Aceita JWT ou o header `x-juridiq-api-key`; o usuário da chave precisa ver processos (403 sem a permissão). parameters: - schema: type: integer default: 1 exclusiveMinimum: 0 in: query name: page required: false description: Página. Começa em 1 - schema: type: integer maximum: 1000 default: 30 exclusiveMinimum: 0 in: query name: limit required: false description: >- Itens por página. Até 1000: a aba do processo carrega todos de uma vez - schema: type: string enum: - asc - desc in: query name: orderBy required: false description: 'asc ou desc (padrão: desc)' - schema: anyOf: - type: string enum: - 'true' - 'false' - type: boolean in: query name: grouped required: false description: >- true: pagina por processo e traz os andamentos de cada um em groups (data vazio) - schema: type: string maxLength: 200 in: query name: keySearch required: false description: Trecho buscado no conteúdo do andamento ou no número do processo - schema: type: string enum: - 'true' - 'false' in: query name: isHandled required: false description: 'true: lidos; false: não lidos' - schema: type: string format: uuid in: query name: lawSuitId required: false description: >- Todos os andamentos do processo. Sem ele: os andamentos novos do escritório - schema: anyOf: - type: string enum: - MANUAL - COURT_LAWSUIT_INSTANCE - COURT_LAWSUIT_ROW - SECRET - INSS - type: array items: type: string enum: - MANUAL - COURT_LAWSUIT_INSTANCE - COURT_LAWSUIT_ROW - SECRET - INSS in: query name: sources required: false - schema: anyOf: - type: string maxLength: 40 - type: array items: type: string maxLength: 40 in: query name: kinds required: false - schema: type: string maxLength: 40 in: query name: courtAcronym required: false - schema: type: string format: uuid in: query name: tagId required: false - schema: type: integer exclusiveMinimum: 0 in: query name: instance required: false - schema: type: string format: date in: query name: start required: false description: Data inicial do andamento (YYYY-MM-DD, São Paulo) - schema: type: string format: date in: query name: end required: false description: Data final do andamento, inclusive (YYYY-MM-DD) - schema: type: string format: date in: query name: readStart required: false description: Data inicial de leitura (YYYY-MM-DD, São Paulo) - schema: type: string format: date in: query name: readEnd required: false description: Data final de leitura, inclusive (YYYY-MM-DD) responses: '200': description: Default Response content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: string lawSuitId: type: string nullable: true processNumber: type: string externalId: type: string source: type: string enum: - MANUAL - COURT_LAWSUIT_INSTANCE - COURT_LAWSUIT_ROW - SECRET - INSS kind: type: string nullable: true courtAcronym: type: string nullable: true courtDegree: type: number nullable: true instance: type: number nullable: true lawSuitInstanceId: type: string nullable: true movementDate: type: string nullable: true rawDate: type: string nullable: true content: type: string authorName: type: string nullable: true metadata: nullable: true isShared: type: boolean isHandled: type: boolean description: Já lido readAt: type: string nullable: true description: Data da leitura readBy: type: object properties: id: type: string name: type: string required: - id - name additionalProperties: false nullable: true description: Quem leu createdAt: type: string tags: type: array items: type: object properties: id: type: string name: type: string color: type: string nullable: true required: - id - name - color additionalProperties: false required: - id - lawSuitId - processNumber - externalId - source - kind - courtAcronym - courtDegree - instance - lawSuitInstanceId - movementDate - rawDate - content - authorName - isShared - isHandled - readAt - readBy - createdAt - tags additionalProperties: false description: Andamentos groups: type: array items: type: object properties: processNumber: type: string lawSuitId: type: string nullable: true latestAt: type: string description: Andamento mais recente do processo na lista totalCount: type: integer description: Andamentos do processo com os filtros unreadCount: type: integer description: Não lidos do processo com os filtros items: type: array items: type: object properties: id: type: string lawSuitId: type: string nullable: true processNumber: type: string externalId: type: string source: type: string enum: - MANUAL - COURT_LAWSUIT_INSTANCE - COURT_LAWSUIT_ROW - SECRET - INSS kind: type: string nullable: true courtAcronym: type: string nullable: true courtDegree: type: number nullable: true instance: type: number nullable: true lawSuitInstanceId: type: string nullable: true movementDate: type: string nullable: true rawDate: type: string nullable: true content: type: string authorName: type: string nullable: true metadata: nullable: true isShared: type: boolean isHandled: type: boolean description: Já lido readAt: type: string nullable: true description: Data da leitura readBy: type: object properties: id: type: string name: type: string required: - id - name additionalProperties: false nullable: true description: Quem leu createdAt: type: string tags: type: array items: type: object properties: id: type: string name: type: string color: type: string nullable: true required: - id - name - color additionalProperties: false required: - id - lawSuitId - processNumber - externalId - source - kind - courtAcronym - courtDegree - instance - lawSuitInstanceId - movementDate - rawDate - content - authorName - isShared - isHandled - readAt - readBy - createdAt - tags additionalProperties: false description: Os andamentos do processo, até 20, na ordem pedida required: - processNumber - lawSuitId - latestAt - totalCount - unreadCount - items additionalProperties: false nullable: true description: >- Só com grouped=true: processos paginados, cada um com os seus andamentos sum: type: object properties: total: type: number description: Total read: type: number description: Lidos unread: type: number description: Não lidos readInPeriod: type: number description: >- Lidos dentro do intervalo de readStart/readEnd. Ausente sem o filtro required: - total - read - unread additionalProperties: false description: Totais totalPages: type: number description: Total de páginas totalResults: type: number description: Total de registros canHandle: type: boolean description: >- Pode marcar como lido: Gestor ou quem está em "Tratar andamentos" required: - data - sum - totalPages - totalResults - canHandle additionalProperties: false '400': description: Default Response content: application/json: schema: type: object properties: message: type: string issues: {} required: - message additionalProperties: false '401': description: Default Response content: application/json: schema: type: object properties: message: type: string statusCode: type: number translateMessage: type: string required: - message - statusCode - translateMessage additionalProperties: false '403': description: Default Response content: application/json: schema: type: object properties: message: type: string statusCode: type: number translateMessage: type: string required: - message - statusCode - translateMessage additionalProperties: false '404': description: Default Response content: application/json: schema: type: object properties: message: type: string statusCode: type: number translateMessage: type: string required: - message - statusCode - translateMessage additionalProperties: false security: - apiKeyAuth: [] components: securitySchemes: apiKeyAuth: type: apiKey in: header name: x-juridiq-api-key description: >- Chave de API do escritório (criada no painel). Envie o valor no header x-juridiq-api-key. A API aberta aplica rate limit por chave (veja a documentação de integradores). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.