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

# asyncReport

> This query returns that status of the async reports

`Query`

## Arguments

<ParamField path="input" type="AsyncReportInput!" required>
  <Expandable title="child attributes">
    <ParamField path="orderBy" type="[AsyncReportsSortTypeInput!]">
      <Expandable title="child attributes">
        <ParamField path="field" type="AsyncReportsSortField!" required>
          <Expandable title="Possible enum values">
            <ParamField path="REQUESTED_DATE" type="enum" />
          </Expandable>
        </ParamField>

        <ParamField path="sortDirection" type="SortingEnumType!" required>
          See [SortingEnumType](/acquiring/reference/graphql/types/sorting-enum-type)
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField path="paging" type="PagingInput!" required>
      See [PagingInput](/acquiring/reference/graphql/types/paging-input)
    </ParamField>

    <ParamField path="where" type="AsyncReportFilterInput!" required>
      <Expandable title="child attributes">
        <ParamField path="requestedDate" type="DateFilterInput!" required>
          <Expandable title="child attributes">
            <ParamField path="eq" type="Date" />

            <ParamField path="gt" type="Date" />

            <ParamField path="gte" type="Date" />

            <ParamField path="lt" type="Date" />

            <ParamField path="lte" type="Date" />

            <ParamField path="neq" type="Date" />

            <ParamField path="ngt" type="Date" />

            <ParamField path="ngte" type="Date" />

            <ParamField path="nlt" type="Date" />

            <ParamField path="nlte" type="Date" />
          </Expandable>
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

## Return type

`AsyncReportRequestCollection`

<ResponseField name="items" type="[AsyncReportRequest!]!" required>
  <Expandable title="child attributes">
    <ResponseField name="description" type="String" />

    <ResponseField name="expiresDateTime" type="DateTime!" required />

    <ResponseField name="fileName" type="String" />

    <ResponseField name="fileSize" type="Long" />

    <ResponseField name="fileType" type="FileTypes!" required>
      <Expandable title="Possible enum values">
        <ResponseField name="CSV" type="enum" />
      </Expandable>
    </ResponseField>

    <ResponseField name="generatedDateTime" type="DateTime" />

    <ResponseField name="isCompressed" type="Boolean!" required />

    <ResponseField name="presenter" type="Presenter">
      <Expandable title="child attributes">
        <ResponseField name="businessName" type="String!" required>
          The descriptive name for the presenter that is different from its legal entity name. Also known as "Doing Business As" (DBA), "trade name", "assumed name", or "fictitious name".
        </ResponseField>

        <ResponseField name="id" type="UUID!" required>
          The id of the presenter as defined in their profile.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="reportId" type="UUID" />

    <ResponseField name="requestedDateTime" type="DateTime!" required />

    <ResponseField name="requestId" type="UUID!" required />

    <ResponseField name="status" type="AsyncReportStatus!" required>
      <Expandable title="Possible enum values">
        <ResponseField name="RECEIVED" type="enum" />

        <ResponseField name="FILE_GENERATED" type="enum" />

        <ResponseField name="FAILED" type="enum" />

        <ResponseField name="READY" type="enum" />

        <ResponseField name="ALREADY_DOWNLOADED" type="enum" />
      </Expandable>
    </ResponseField>

    <ResponseField name="tags" type="[String!]" />

    <ResponseField name="url" type="String" />

    <ResponseField name="user" type="User">
      <Expandable title="child attributes">
        <ResponseField name="address" type="AddressOutput">
          The address of the user.

          See [AddressOutput](/acquiring/reference/graphql/types/address-output)
        </ResponseField>

        <ResponseField name="defaultOrganizationId" type="UUID!" required>
          The id of the organization that the user is associated with.
        </ResponseField>

        <ResponseField name="email" type="String!" required>
          The email address of the user.
        </ResponseField>

        <ResponseField name="embeddedBankAccounts" type="[EmbeddedBankAccount!]!" required>
          Embedded bank accounts that this user has been granted access to

          <Expandable title="child attributes">
            <ResponseField name="accountNumber" type="String!" required>
              Bank account number
            </ResponseField>

            <ResponseField name="id" type="UUID!" required>
              Unique identifier for the bank account
            </ResponseField>

            <ResponseField name="nickname" type="String">
              Display name for the bank account
            </ResponseField>

            <ResponseField name="routingNumber" type="String!" required>
              Bank routing number
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="externalBankAccounts" type="[ExternalBankAccount!]!" required>
          External bank accounts that this user has been granted access to

          <Expandable title="child attributes">
            <ResponseField name="accountNumber" type="String!" required>
              Last four digits of the account number
            </ResponseField>

            <ResponseField name="id" type="UUID!" required>
              Unique identifier for the external bank account
            </ResponseField>

            <ResponseField name="nameOnAccount" type="String!" required>
              Name on the external bank account
            </ResponseField>

            <ResponseField name="nickname" type="String!" required>
              Display name for the external bank account
            </ResponseField>

            <ResponseField name="routingNumber" type="String!" required>
              Bank routing number
            </ResponseField>

            <ResponseField name="type" type="BankAccountType!" required>
              Type of bank account (Checking or Savings)

              See [BankAccountType](/acquiring/reference/graphql/types/bank-account-type)
            </ResponseField>

            <ResponseField name="verificationStatus" type="ExternalBankAccountVerificationStatus!" required>
              Current verification status of the external account

              <Expandable title="Possible enum values">
                <ResponseField name="UNVERIFIED" type="enum">
                  Account is not yet verified
                </ResponseField>

                <ResponseField name="VERIFIED" type="enum">
                  Account has been successfully verified
                </ResponseField>

                <ResponseField name="FAILED" type="enum">
                  Account verification has failed
                </ResponseField>
              </Expandable>
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="id" type="UUID!" required>
          The id of the user as defined in their profile.
        </ResponseField>

        <ResponseField name="jobTitle" type="String">
          The job title of the user.
        </ResponseField>

        <ResponseField name="lastLoggedInDateTime" type="DateTime">
          Last time the user logged in.
        </ResponseField>

        <ResponseField name="name" type="String!" required>
          The display name of the user.
        </ResponseField>

        <ResponseField name="organization" type="Organization">
          See [Organization](/acquiring/reference/graphql/types/organization)
        </ResponseField>

        <ResponseField name="permissions" type="[Permission!]">
          <Expandable title="child attributes">
            <ResponseField name="description" type="String">
              The description of the permission.
            </ResponseField>

            <ResponseField name="id" type="UUID!" required>
              The id of the permission.
            </ResponseField>

            <ResponseField name="key" type="String!" required>
              The key of the permission.
            </ResponseField>

            <ResponseField name="name" type="String!" required>
              The name of the permission.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="phoneNumber" type="String">
          The phone number of the user.
        </ResponseField>

        <ResponseField name="status" type="UserStatus!" required>
          The status of the user.

          <Expandable title="Possible enum values">
            <ResponseField name="ACTIVE" type="enum">
              User account is active and can authenticate and use the application.
            </ResponseField>

            <ResponseField name="INACTIVE" type="enum">
              User account has been deactivated and cannot authenticate or use the application.
            </ResponseField>

            <ResponseField name="INVITED" type="enum">
              User has been invited but has not completed registration or accepted agreements.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="type" type="ActorType!" required>
          The actor type. Always USER for user actors.

          See [ActorType](/acquiring/reference/graphql/types/actor-type)
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pageInfo" type="PageInfo!" required>
  <Expandable title="child attributes">
    <ResponseField name="hasNextPage" type="Boolean!" required />

    <ResponseField name="hasPreviousPage" type="Boolean!" required />
  </Expandable>
</ResponseField>

<RequestExample>
  ```graphql Operation lines expandable theme={null}
  query AsyncReport($input: AsyncReportInput!) {
    asyncReport(input: $input) {
      items {
        description
        expiresDateTime
        fileName
        fileSize
        fileType
        generatedDateTime
        isCompressed
        presenter {
          businessName
          id
        }
        reportId
        requestedDateTime
        requestId
        status
        tags
        url
        user {
          defaultOrganizationId
          email
          id
          jobTitle
          lastLoggedInDateTime
          name
          phoneNumber
          status
          type
        }
      }
      pageInfo {
        hasNextPage
        hasPreviousPage
      }
    }
  }
  ```

  ```json Variables lines expandable theme={null}
  {
    "input": {
      "paging": {
        "skip": 0,
        "take": 0
      },
      "where": {
        "requestedDate": "example"
      }
    }
  }
  ```

  ```bash cURL lines expandable theme={null}
  curl --request POST \
    --url https://api.sandbox.com/graphql \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
    --data '{
    "query": "query AsyncReport($input: AsyncReportInput!) {\n  asyncReport(input: $input) {\n    items {\n      description\n      expiresDateTime\n      fileName\n      fileSize\n      fileType\n      generatedDateTime\n      isCompressed\n      presenter {\n        businessName\n        id\n      }\n      reportId\n      requestedDateTime\n      requestId\n      status\n      tags\n      url\n      user {\n        defaultOrganizationId\n        email\n        id\n        jobTitle\n        lastLoggedInDateTime\n        name\n        phoneNumber\n        status\n        type\n      }\n    }\n    pageInfo {\n      hasNextPage\n      hasPreviousPage\n    }\n  }\n}",
    "variables": {
      "input": {
        "paging": {
          "skip": 0,
          "take": 0
        },
        "where": {
          "requestedDate": "example"
        }
      }
    }
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json Response lines expandable theme={null}
  {
    "data": {
      "asyncReport": {
        "items": [
          {
            "description": "example",
            "expiresDateTime": "2026-01-15T14:30:00Z",
            "fileName": "business-license.pdf",
            "fileSize": 0,
            "fileType": "CSV",
            "generatedDateTime": "2026-01-15T14:30:00Z",
            "isCompressed": true,
            "presenter": {
              "businessName": "Clacksworth Keyboards",
              "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
            },
            "reportId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "requestedDateTime": "2026-01-15T14:30:00Z",
            "requestId": "c9a1e2d3-4b5f-6789-0abc-def123456789",
            "status": "RECEIVED",
            "tags": [
              "example"
            ],
            "url": "example",
            "user": {
              "address": "example",
              "defaultOrganizationId": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
              "email": "example",
              "embeddedBankAccounts": [
                "example"
              ],
              "externalBankAccounts": [
                "example"
              ],
              "id": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
              "jobTitle": "example",
              "lastLoggedInDateTime": "2026-01-15T14:30:00Z",
              "name": "Ben Torres",
              "organization": "example",
              "permissions": [
                "example"
              ],
              "phoneNumber": "example",
              "status": "ACTIVE",
              "type": "APP"
            }
          }
        ],
        "pageInfo": {
          "hasNextPage": true,
          "hasPreviousPage": true
        }
      }
    }
  }
  ```
</ResponseExample>
