> ## Documentation Index
> Fetch the complete documentation index at: https://trigger.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve bulk action

> Retrieve the status and aggregate processing counts for a bulk action.



## OpenAPI

````yaml v3-openapi GET /api/v1/bulk-actions/{bulkActionId}
openapi: 3.1.0
info:
  title: Trigger.dev v3 REST API
  description: >-
    The REST API lets you trigger and manage runs on Trigger.dev. You can
    trigger a run, get the status of a run, and get the results of a run. 
  version: 2024-04
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://api.trigger.dev
    description: Trigger.dev API
security: []
paths:
  /api/v1/bulk-actions/{bulkActionId}:
    get:
      tags:
        - bulk-actions
      summary: Retrieve bulk action
      description: Retrieve the status and aggregate processing counts for a bulk action.
      operationId: retrieve_bulk_action_v1
      parameters:
        - $ref: '#/components/parameters/bulkActionId'
      responses:
        '200':
          description: Successful request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkActionObject'
        '401':
          description: Unauthorized request
        '404':
          description: Resource not found
      security:
        - secretKey: []
      x-codeSamples:
        - lang: typescript
          source: |-
            import { runs } from "@trigger.dev/sdk";

            const action = await runs.bulk.retrieve("bulk_1234");

            console.log(action.status, action.counts);
components:
  parameters:
    bulkActionId:
      in: path
      name: bulkActionId
      required: true
      schema:
        type: string
      description: The ID of a bulk action, starts with `bulk_`.
      example: bulk_1234
  schemas:
    BulkActionObject:
      type: object
      required:
        - id
        - type
        - status
        - counts
        - createdAt
      properties:
        id:
          type: string
          description: The bulk action ID, prefixed with `bulk_`.
          example: bulk_1234
        name:
          type: string
          description: The name provided when the bulk action was created.
        type:
          type: string
          enum:
            - CANCEL
            - REPLAY
        status:
          type: string
          enum:
            - PENDING
            - COMPLETED
            - ABORTED
        counts:
          type: object
          required:
            - total
            - success
            - failure
          properties:
            total:
              type: integer
              description: The number of runs selected when the bulk action was created.
            success:
              type: integer
              description: The number of runs processed successfully.
            failure:
              type: integer
              description: The number of runs that could not be processed.
        createdAt:
          type: string
          format: date-time
        completedAt:
          type: string
          format: date-time
  securitySchemes:
    secretKey:
      type: http
      scheme: bearer
      description: >
        Use a named environment API key. It starts with `tr_dev_sk_`,
        `tr_prod_sk_`, `tr_stg_sk_`, etc.


        Create a named API key in the API Keys section of your Trigger.dev
        project dashboard. Choose the narrowest access preset that supports your
        integration.


        Our TypeScript SDK will default to using the value of the
        `TRIGGER_SECRET_KEY` environment variable if it is set. If you are using
        the SDK in a different environment, you can set the key using the
        `configure` function.


        ```typescript

        import { configure } from "@trigger.dev/sdk";


        configure({ accessToken: "tr_dev_sk_1234" });

        ```

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.