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

# Read an Action run

> 
        Read an Action run by the id returned when it was started.

        The status code does NOT denote the status of the action in an external
        system, but the status of the action processing from Zapier.

        Results are stored for seven days after the action was initially executed.

        **Waiting for a run to finish**

        Pass `wait_seconds` to hold the request until the run finishes or the wait
        runs out, instead of polling. A wait is your budget, not a deadline for the
        run: when it runs out you get the same 202 as any other read, the run keeps
        going, and you can read again with the same id. A read can answer before the
        wait is over, so treat a 202 as "read again", not as "the wait ended". If a
        202 comes back well before your wait is over, wait about a second, or for
        `Retry-After` when the response has one, before you read again.

        **Rate Limits**

        Reads are limited under the `actions_api_results` bucket. When rate limiting
        applies, response headers report the limit and what remains in the current
        window. A 429 carries `Retry-After`.
        



## OpenAPI

````yaml /api-reference/specs/actions.yaml get /actions/v2/runs/{run_id}
openapi: 3.1.0
info:
  title: Actions API
  description: >-
    Public access to Zapier Stored Actions and the runs that execute them —
    create, list, retrieve, update, and delete stored actions; trigger runs and
    fetch run results.
  version: v1/v2
  contact:
    url: https://docs.zapier.com
servers:
  - url: https://api.zapier.com
    description: Production
security:
  - OAuth: []
tags:
  - name: Action Runs
    description: >-
      Operations related to executing single, stand alone actions and fetching
      their run results
  - name: Stored Actions
    description: Operations related to a Stored Action
paths:
  /actions/v2/runs/{run_id}:
    get:
      tags:
        - Action Runs
      summary: Read an Action run
      description: |2-

                Read an Action run by the id returned when it was started.

                The status code does NOT denote the status of the action in an external
                system, but the status of the action processing from Zapier.

                Results are stored for seven days after the action was initially executed.

                **Waiting for a run to finish**

                Pass `wait_seconds` to hold the request until the run finishes or the wait
                runs out, instead of polling. A wait is your budget, not a deadline for the
                run: when it runs out you get the same 202 as any other read, the run keeps
                going, and you can read again with the same id. A read can answer before the
                wait is over, so treat a 202 as "read again", not as "the wait ended". If a
                202 comes back well before your wait is over, wait about a second, or for
                `Retry-After` when the response has one, before you read again.

                **Rate Limits**

                Reads are limited under the `actions_api_results` bucket. When rate limiting
                applies, response headers report the limit and what remains in the current
                window. A 429 carries `Retry-After`.
                
      operationId: getActionRun_v2
      parameters:
        - in: path
          name: run_id
          schema:
            type: string
            format: uuid
          required: true
        - in: query
          name: wait_seconds
          schema:
            type: integer
            minimum: 0
          description: >-
            How long to wait for the run to finish, in seconds. Values above 30
            are treated as 30. 0 or absent answers at once.
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionRunResult'
              examples:
                Success:
                  value:
                    id: 3b6fab00-8c4f-488d-b6fd-b324e8e17dfb
                    status: success
                    results:
                      - key: value
                    next_page: '0'
                    errors: []
          description: The run has finished, or is waiting on a callback.
          headers:
            X-RateLimit-Limit:
              schema:
                type: integer
              description: >-
                Effective request cap for this caller in the current 300-second
                window. Configured per environment and may be raised by a
                limit_override claim, so read the value from this header rather
                than assuming a fixed limit.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: Requests remaining in the current window.
            X-RateLimit-Reset:
              schema:
                type: string
                format: date-time
              description: Unix timestamp when the current 300-second window resets.
        '202':
          description: The run has not finished. No body. Read again with the same id.
          headers:
            X-RateLimit-Limit:
              schema:
                type: integer
              description: >-
                Effective request cap for this caller in the current 300-second
                window. Configured per environment and may be raised by a
                limit_override claim, so read the value from this header rather
                than assuming a fixed limit.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: Requests remaining in the current window.
            X-RateLimit-Reset:
              schema:
                type: string
                format: date-time
              description: Unix timestamp when the current 300-second window resets.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionRunErrorResponse'
          description: Invalid request.
          headers:
            X-RateLimit-Limit:
              schema:
                type: integer
              description: >-
                Effective request cap for this caller in the current 300-second
                window. Configured per environment and may be raised by a
                limit_override claim, so read the value from this header rather
                than assuming a fixed limit.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: Requests remaining in the current window.
            X-RateLimit-Reset:
              schema:
                type: string
                format: date-time
              description: Unix timestamp when the current 300-second window resets.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionRunErrorResponse'
          description: Missing or invalid credentials.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionRunErrorResponse'
          description: Permission denied.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionRunErrorResponse'
              examples:
                NotFound:
                  value:
                    errors:
                      - status: '404'
                        code: execution_not_found
                        title: Not Found
                        detail: No results found for this run.
                  summary: Not found
          description: No results for this run.
          headers:
            X-RateLimit-Limit:
              schema:
                type: integer
              description: >-
                Effective request cap for this caller in the current 300-second
                window. Configured per environment and may be raised by a
                limit_override claim, so read the value from this header rather
                than assuming a fixed limit.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: Requests remaining in the current window.
            X-RateLimit-Reset:
              schema:
                type: string
                format: date-time
              description: Unix timestamp when the current 300-second window resets.
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionRunErrorResponse'
          description: Rate limit exceeded.
          headers:
            X-RateLimit-Limit:
              schema:
                type: integer
              description: >-
                Effective request cap for this caller in the current 300-second
                window. Configured per environment and may be raised by a
                limit_override claim, so read the value from this header rather
                than assuming a fixed limit.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: Requests remaining in the current window.
            X-RateLimit-Reset:
              schema:
                type: string
                format: date-time
              description: Unix timestamp when the current 300-second window resets.
            Retry-After:
              schema:
                type: integer
              description: Seconds to wait before retrying.
              required: true
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionRunErrorResponse'
          description: Internal Server Error
          headers:
            X-RateLimit-Limit:
              schema:
                type: integer
              description: >-
                Effective request cap for this caller in the current 300-second
                window. Configured per environment and may be raised by a
                limit_override claim, so read the value from this header rather
                than assuming a fixed limit.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: Requests remaining in the current window.
            X-RateLimit-Reset:
              schema:
                type: string
                format: date-time
              description: Unix timestamp when the current 300-second window resets.
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionRunErrorResponse'
          description: Service Unavailable
          headers:
            X-RateLimit-Limit:
              schema:
                type: integer
              description: >-
                Effective request cap for this caller in the current 300-second
                window. Configured per environment and may be raised by a
                limit_override claim, so read the value from this header rather
                than assuming a fixed limit.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: Requests remaining in the current window.
            X-RateLimit-Reset:
              schema:
                type: string
                format: date-time
              description: Unix timestamp when the current 300-second window resets.
            Retry-After:
              schema:
                type: integer
              description: Seconds to wait before retrying.
              required: true
      security:
        - OAuth:
            - external
components:
  schemas:
    ActionRunResult:
      type: object
      description: 'An action run: a bare object with no `data` wrapper and no `type` tag.'
      properties:
        id:
          type: string
          format: uuid
          description: The id returned when the run was started.
        status:
          allOf:
            - $ref: '#/components/schemas/StatusEnum'
          description: >-
            The result of the action call itself from the partner. You could
            have a success=True (Zapier succeeded) and status=error (the partner
            raise an error).


            * `error` - error

            * `success` - success

            * `waiting` - waiting
        results:
          type: array
          items:
            type: object
            additionalProperties: {}
          description: Could be empty, even if the action was successfully run.
        next_page:
          type: string
          description: >-
            When using bulk read action types, this denotes the state of the
            paging utilities. Pass it back as `page` when starting the next run.
        errors:
          type: array
          items:
            $ref: '#/components/schemas/ActionsFetchError'
          description: Any errors returned by the partner when running this action.
      required:
        - errors
        - id
    ActionRunErrorResponse:
      type: object
      properties:
        errors:
          type: array
          items:
            $ref: '#/components/schemas/ActionRunError'
          description: An array of error objects.
      required:
        - errors
    StatusEnum:
      enum:
        - error
        - success
        - waiting
      type: string
      description: |-
        * `error` - error
        * `success` - success
        * `waiting` - waiting
    ActionsFetchError:
      type: object
      description: >-
        The error information returned from a third party when running an
        action.
      properties:
        code:
          allOf:
            - $ref: '#/components/schemas/CodeEnum'
          description: |-
            Error type of the result object.

            * `user` - user
            * `authentication` - authentication
            * `partner` - partner
            * `system` - system
            * `throttled` - throttled
            * `system_throttled` - system_throttled
            * `hydration` - hydration
            * `authentication_access` - authentication_access
        title:
          type: string
          description: A short summary of the problem.
        detail:
          type: string
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
        delay:
          type: integer
          description: >-
            When a partner throttled the execution call (error_type =
            throttled), this value will hold the number of seconds to wait
            before retrying.
        meta:
          type:
            - object
            - 'null'
          additionalProperties: {}
          description: Any additional error information returned from the partner.
    ActionRunError:
      type: object
      description: Base Error definition
      properties:
        status:
          type: string
          description: The HTTP status code applicable to this problem, as a string.
        code:
          type: string
          description: A unique identifier for this particular occurrence of the problem.
        title:
          type: string
          description: A short summary of the problem.
        detail:
          type: string
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
        source:
          oneOf:
            - $ref: '#/components/schemas/ActionsErrorSource'
            - type: 'null'
          description: An object containing references to the primary source of the error.
        meta:
          type:
            - object
            - 'null'
          additionalProperties: {}
          description: Any additional metadata about the error.
    CodeEnum:
      enum:
        - user
        - authentication
        - partner
        - system
        - throttled
        - system_throttled
        - hydration
        - authentication_access
      type: string
      description: |-
        * `user` - user
        * `authentication` - authentication
        * `partner` - partner
        * `system` - system
        * `throttled` - throttled
        * `system_throttled` - system_throttled
        * `hydration` - hydration
        * `authentication_access` - authentication_access
    ActionsErrorSource:
      type: object
      description: Populates the `source` object inside our error responses.
      properties:
        pointer:
          type: string
          description: >-
            Pointer to the value in the request document that caused the error
            e.g. `/actions`.
        parameter:
          type: string
          description: A string indicating which URI query parameter caused the error.
        header:
          type: string
          description: >-
            A string indicating the name of a single request header which caused
            the error.
  securitySchemes:
    OAuth:
      type: oauth2
      description: OAuth 2.0 authentication.
      flows:
        authorizationCode:
          authorizationUrl: https://zapier.com/oauth/authorize
          tokenUrl: https://zapier.com/oauth/token
          scopes:
            external: Scope that gives access to all Public APIs
        clientCredentials:
          tokenUrl: https://zapier.com/oauth/token
          scopes:
            external: Scope that gives access to all Public APIs

````