> ## 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.

# underwritingAccount

> Retrieves an underwriting account by its identifier. An account the caller cannot see is reported as not found.

`Query`

## Arguments

**id** `UUID!` *required*

The unique identifier of the account.

## Return type

`UnderwritingAccount`

**activeReviewId** `UUID`

The unique identifier of the review application in progress on the account. Null when no review is
in progress.

**currentApplication** `UnderwritingApplication`

The most recently approved application, which holds the account's current details.

**child attributes**

**applicationEvents** `ApplicationEventCollection`

The events associated with the application.

See [ApplicationEventCollection](https://docs.tesouro.com/underwriting/reference/graphql/types/application-event-collection.md)

**applicationIdentity** `UnderwritingApplicationIdentity`

The identity information of the application.

See [UnderwritingApplicationIdentity](https://docs.tesouro.com/underwriting/reference/graphql/types/underwriting-application-identity.md)

**applicationStatus** `UnderwritingApplicationStatus!` *required*

The status of the application.

See [UnderwritingApplicationStatus](https://docs.tesouro.com/underwriting/reference/graphql/types/underwriting-application-status.md)

**assignee** `ApplicationAssignee`

The user assigned to the application.

See [ApplicationAssignee](https://docs.tesouro.com/underwriting/reference/graphql/types/application-assignee.md)

**attachments** `[Attachment!]!` *required*

The attachments associated with the application.

See [Attachment](https://docs.tesouro.com/underwriting/reference/graphql/types/attachment.md)

**bankAccounts** `[UnderwritingBankAccount!]`

Bank account information. Optionally reveal sensitive fields for a specific bank account.

See [UnderwritingBankAccount](https://docs.tesouro.com/underwriting/reference/graphql/types/underwriting-bank-account.md)

**comments** `[Comment!]!` *required*

The comments associated with the application.

See [Comment](https://docs.tesouro.com/underwriting/reference/graphql/types/comment.md)

**createdBy** `Actor`

The actor who created the application.

See [Actor](https://docs.tesouro.com/underwriting/reference/graphql/types/actor.md)

**createdDateTime** `DateTime!` *required*

The date and time when the application was created.

**decisionComponents** `[DecisionComponent!]!` *required*

The underwriting decision components for the application.

See [DecisionComponent](https://docs.tesouro.com/underwriting/reference/graphql/types/decision-component.md)

**declineComment** `Max1000Text`

The underwriter's free-text explanation of the decline. Null when the application is not declined or no comment has been entered.

**declineReasons** `[DeclineReason!]!` *required*

The decline reasons associated with the application. Empty when no reasons have been selected.

See [DeclineReason](https://docs.tesouro.com/underwriting/reference/graphql/types/decline-reason.md)

**dynamicField** `UnderwritingDynamicField`

A single dynamic field value looked up by the stable key of its root schema node, enabling field-style aliasing. Optionally scope to a decision-component item.

See [UnderwritingDynamicField](https://docs.tesouro.com/underwriting/reference/graphql/types/underwriting-dynamic-field.md)

**dynamicFields** `[UnderwritingDynamicField!]!` *required*

The dynamic field values captured on this application, assembled into the catalog's recursive shape. Optionally scope to a single decision-component item (e.g. one owner); omit to return the values across all decision-component items and the application level.

See [UnderwritingDynamicField](https://docs.tesouro.com/underwriting/reference/graphql/types/underwriting-dynamic-field.md)

**id** `UUID!` *required*

The unique identifier of the application.

**informationRequests** `[UnderwritingInformationRequest!]!` *required*

Information requests for this application.

See [UnderwritingInformationRequest](https://docs.tesouro.com/underwriting/reference/graphql/types/underwriting-information-request.md)

**informationRequestStatus** `UnderwritingApplicationInformationRequestStatus!` *required*

The status of information requests for this application.

See [UnderwritingApplicationInformationRequestStatus](https://docs.tesouro.com/underwriting/reference/graphql/types/underwriting-application-information-request-status.md)

**kind** `UnderwritingApplicationKind!` *required*

The kind of underwriting application.

See [UnderwritingApplicationKind](https://docs.tesouro.com/underwriting/reference/graphql/types/underwriting-application-kind.md)

**participants** `[BoardingApplicationParticipant!]`

The participants of the application.

See [BoardingApplicationParticipant](https://docs.tesouro.com/underwriting/reference/graphql/types/boarding-application-participant.md)

**primaryUnderwriter** `ApplicationUnderwriter`

The primary underwriter of the application.

See [ApplicationUnderwriter](https://docs.tesouro.com/underwriting/reference/graphql/types/application-underwriter.md)

**processingActivity** `UnderwritingApplicationProcessingActivityOutput`

The process activity information of the application.

See [UnderwritingApplicationProcessingActivityOutput](https://docs.tesouro.com/underwriting/reference/graphql/types/underwriting-application-processing-activity-output.md)

**queue** `WorkflowAssignment!` *required*

The queue the application is assigned to.

See [WorkflowAssignment](https://docs.tesouro.com/underwriting/reference/graphql/types/workflow-assignment.md)

**relationshipProcessingActivity** `RelationshipProcessingActivityOutput`

The relationship-wide processing activity totals across all locations in the relationship, including this application. Null when not yet captured.

See [RelationshipProcessingActivityOutput](https://docs.tesouro.com/underwriting/reference/graphql/types/relationship-processing-activity-output.md)

**schema** `UnderwritingDecisionComponentsSchema`

The underwriting decision components schema for the application.

See [UnderwritingDecisionComponentsSchema](https://docs.tesouro.com/underwriting/reference/graphql/types/underwriting-decision-components-schema.md)

**secondaryUnderwriter** `ApplicationUnderwriter`

The secondary underwriter of the application.

See [ApplicationUnderwriter](https://docs.tesouro.com/underwriting/reference/graphql/types/application-underwriter.md)

**stakeholders** `[StakeholderOutput!]!` *required*

Stakeholder information. Optionally reveal sensitive fields for a specific stakeholder.

See [StakeholderOutput](https://docs.tesouro.com/underwriting/reference/graphql/types/stakeholder-output.md)

**submissionAttemptedDateTime** `DateTime`

The date and time when the application submission was attempted.

**submissionSuccessfulDateTime** `DateTime`

The date and time when the application was successfully submitted.

**updatedBy** `Actor`

The actor who updated the application.

See [Actor](https://docs.tesouro.com/underwriting/reference/graphql/types/actor.md)

**updatedDateTime** `DateTime!` *required*

The date and time when the application was last updated.

**events** `UnderwritingAccountEventCollection!` *required*

The events recorded on the account, newest first.

**child attributes**

**items** `[UnderwritingAccountEvent!]!` *required*

See [UnderwritingAccountEvent](https://docs.tesouro.com/underwriting/reference/graphql/types/underwriting-account-event.md)

**pageInfo** `PageInfo!` *required*

See [PageInfo](https://docs.tesouro.com/underwriting/reference/graphql/types/page-info.md)

**id** `UUID!` *required*

The unique identifier of the account.

**status** `UnderwritingAccountStatus!` *required*

The status of the account.

**Possible enum values**

**CLOSED** `enum`

The merchant is no longer active. A closed account stays closed.

**OPEN** `enum`

The merchant is active.

```graphql Operation lines expandable theme={null}
query UnderwritingAccount($id: UUID!) {
  underwritingAccount(id: $id) {
    activeReviewId
    currentApplication {
      applicationEvents {

      }
      applicationIdentity {
        applicantType
        businessEntityType
        businessName
        caseOriginator
        isDisregardedEntity
        isKnownEntity
        isLegalAddressSameAsBusinessAddress
        legalEntityName
        merchantCategoryCode
        naicsCode
        naicsDescription
        salesChannel
        serviceTelephoneNumber
        softwareProviderNames
        stateOfIncorporation
        underwritingReference
        underwritingRelationshipReference
        websiteUrl
      }
      applicationStatus
      assignee {
        assignedDateTime
        name
        userId
      }
      attachments {
        fileName
        id
        size
        uploadedDateTime
      }
      bankAccounts {
        accountNumberLast4
        id
        referenceNumber
        routingNumber
      }
      comments {
        content
        createdDateTime
        id
        updatedDateTime
      }
      createdBy {
        name
        type
      }
      createdDateTime
      decisionComponents {
        hasAttachments
        hasComments
        id
        status
        updatedDateTime
      }
      declineComment
      declineReasons {
        code
        message
      }
      dynamicField {
        children
        decisionComponentItemId
        fieldValue
        id
        parentDynamicFieldId
        selectedVariantKey
      }
      dynamicFields {
        children
        decisionComponentItemId
        fieldValue
        id
        parentDynamicFieldId
        selectedVariantKey
      }
      id
      informationRequests {
        applicationId
        createdDateTime
        description
        fulfilledDateTime
        fulfillmentAttachmentIds
        fulfillmentResponse
        fulfillmentTypes
        id
        status
        title
        type
        updatedDateTime
      }
      informationRequestStatus
      kind
      participants {
        role
      }
      primaryUnderwriter {
        name
        userId
      }
      processingActivity {
        advancedPaymentRate
        averageAnnualSalesAmount
        averageMonthlySalesAmount
        averageTicketAmount
        businessToBusinessMix
        cardNotPresentMix
        cardPresentMix
        chargebackRate
        currency
        customerInitiatedCardNotPresentMix
        daysInCycle
        deliveryTimeframe
        exposure
        highestTicketAmount
        merchantInitiatedCardNotPresentMix
        refundRate
        riskLevel
      }
      queue
      relationshipProcessingActivity {
        advancedPaymentRate
        averageAnnualSalesAmount
        averageMonthlySalesAmount
        averageTicketAmount
        businessToBusinessMix
        cardNotPresentMix
        cardPresentMix
        chargebackRate
        currency
        customerInitiatedCardNotPresentMix
        daysInCycle
        deliveryTimeframe
        exposure
        highestTicketAmount
        merchantInitiatedCardNotPresentMix
        refundRate
        riskLevel
      }
      schema {
        createdDateTime
        id
        version
      }
      secondaryUnderwriter {
        name
        userId
      }
      stakeholders {
        emailAddress
        id
        ipAddress
        ownershipPercentage
        referenceNumber
        roles
      }
      submissionAttemptedDateTime
      submissionSuccessfulDateTime
      updatedBy {
        name
        type
      }
      updatedDateTime
    }
    events {
      items {
        applicationId
        createdDateTime
        displayInformation
        eventType
        id
      }
      pageInfo {
        hasNextPage
        hasPreviousPage
      }
    }
    id
    status

}
}

```

```json Variables lines expandable theme={null}
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
```

```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 UnderwritingAccount($id: UUID!) {\n  underwritingAccount(id: $id) {\n    activeReviewId\n    currentApplication {\n      applicationEvents {\n\n      }\n      applicationIdentity {\n        applicantType\n        businessEntityType\n        businessName\n        caseOriginator\n        isDisregardedEntity\n        isKnownEntity\n        isLegalAddressSameAsBusinessAddress\n        legalEntityName\n        merchantCategoryCode\n        naicsCode\n        naicsDescription\n        salesChannel\n        serviceTelephoneNumber\n        softwareProviderNames\n        stateOfIncorporation\n        underwritingReference\n        underwritingRelationshipReference\n        websiteUrl\n      }\n      applicationStatus\n      assignee {\n        assignedDateTime\n        name\n        userId\n      }\n      attachments {\n        fileName\n        id\n        size\n        uploadedDateTime\n      }\n      bankAccounts {\n        accountNumberLast4\n        id\n        referenceNumber\n        routingNumber\n      }\n      comments {\n        content\n        createdDateTime\n        id\n        updatedDateTime\n      }\n      createdBy {\n        name\n        type\n      }\n      createdDateTime\n      decisionComponents {\n        hasAttachments\n        hasComments\n        id\n        status\n        updatedDateTime\n      }\n      declineComment\n      declineReasons {\n        code\n        message\n      }\n      dynamicField {\n        children\n        decisionComponentItemId\n        fieldValue\n        id\n        parentDynamicFieldId\n        selectedVariantKey\n      }\n      dynamicFields {\n        children\n        decisionComponentItemId\n        fieldValue\n        id\n        parentDynamicFieldId\n        selectedVariantKey\n      }\n      id\n      informationRequests {\n        applicationId\n        createdDateTime\n        description\n        fulfilledDateTime\n        fulfillmentAttachmentIds\n        fulfillmentResponse\n        fulfillmentTypes\n        id\n        status\n        title\n        type\n        updatedDateTime\n      }\n      informationRequestStatus\n      kind\n      participants {\n        role\n      }\n      primaryUnderwriter {\n        name\n        userId\n      }\n      processingActivity {\n        advancedPaymentRate\n        averageAnnualSalesAmount\n        averageMonthlySalesAmount\n        averageTicketAmount\n        businessToBusinessMix\n        cardNotPresentMix\n        cardPresentMix\n        chargebackRate\n        currency\n        customerInitiatedCardNotPresentMix\n        daysInCycle\n        deliveryTimeframe\n        exposure\n        highestTicketAmount\n        merchantInitiatedCardNotPresentMix\n        refundRate\n        riskLevel\n      }\n      queue\n      relationshipProcessingActivity {\n        advancedPaymentRate\n        averageAnnualSalesAmount\n        averageMonthlySalesAmount\n        averageTicketAmount\n        businessToBusinessMix\n        cardNotPresentMix\n        cardPresentMix\n        chargebackRate\n        currency\n        customerInitiatedCardNotPresentMix\n        daysInCycle\n        deliveryTimeframe\n        exposure\n        highestTicketAmount\n        merchantInitiatedCardNotPresentMix\n        refundRate\n        riskLevel\n      }\n      schema {\n        createdDateTime\n        id\n        version\n      }\n      secondaryUnderwriter {\n        name\n        userId\n      }\n      stakeholders {\n        emailAddress\n        id\n        ipAddress\n        ownershipPercentage\n        referenceNumber\n        roles\n      }\n      submissionAttemptedDateTime\n      submissionSuccessfulDateTime\n      updatedBy {\n        name\n        type\n      }\n      updatedDateTime\n    }\n    events {\n      items {\n        applicationId\n        createdDateTime\n        displayInformation\n        eventType\n        id\n      }\n      pageInfo {\n        hasNextPage\n        hasPreviousPage\n      }\n    }\n    id\n    status\n  }\n}",
  "variables": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}'
```

```json Response lines expandable theme={null}
{
  "data": {
    "underwritingAccount": {
      "activeReviewId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "currentApplication": {
        "applicationEvents": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "applicationIdentity": {
          "applicantType": "BILLER",
          "businessAddress": "example",
          "businessEntityType": "ASSOCIATION",
          "businessName": "Clacksworth Keyboards",
          "caseOriginator": "example",
          "isDisregardedEntity": true,
          "isKnownEntity": true,
          "isLegalAddressSameAsBusinessAddress": true,
          "legalAddress": "example",
          "legalEntityName": "Clacksworth Keyboards LLC",
          "merchantCategoryCode": "example",
          "naicsCode": "example",
          "naicsDescription": "example",
          "salesChannel": "E_COMMERCE",
          "sensitiveFields": "example",
          "serviceTelephoneNumber": "+15551234567",
          "softwareProviderNames": [
            "example"
          ],
          "stateOfIncorporation": "example",
          "taxIdentificationNumber": "example",
          "underwritingReference": "example",
          "underwritingRelationshipReference": "example",
          "websiteUrl": "https://clacksworth.com"
        },
        "applicationStatus": "APPROVED",
        "assignee": {
          "assignedBy": "example",
          "assignedDateTime": "2026-01-15T14:30:00Z",
          "name": "Ben Torres",
          "userId": "c9a1e2d3-4b5f-6789-0abc-def123456789"
        },
        "attachments": [
          {
            "fileName": "business-license.pdf",
            "id": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
            "size": 0,
            "uploadedBy": "example",
            "uploadedDateTime": "2026-01-15T14:30:00Z"
          }
        ],
        "bankAccounts": [
          {
            "accountNumberLast4": "example",
            "id": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
            "referenceNumber": 0,
            "routingNumber": "example",
            "sensitiveFields": "example"
          }
        ],
        "comments": [
          {
            "content": "Approved for mechanical keyboard accessories line.",
            "createdBy": "example",
            "createdDateTime": "2026-01-15T14:30:00Z",
            "decisionComponent": "example",
            "id": "b6d4e5f6-7a8b-9012-3def-456789012345",
            "lastUpdatedBy": "example",
            "updatedDateTime": "2026-01-15T14:30:00Z"
          }
        ],
        "createdBy": {
          "name": "Ben Torres",
          "type": "APP"
        },
        "createdDateTime": "2026-01-15T14:30:00Z",
        "decisionComponents": [
          {
            "attachments": [
              "example"
            ],
            "comments": [
              "example"
            ],
            "hasAttachments": true,
            "hasComments": true,
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "items": [
              "example"
            ],
            "lastUpdatedBy": "example",
            "schema": "example",
            "status": "ACCEPTED",
            "updatedDateTime": "2026-01-15T14:30:00Z"
          }
        ],
        "declineComment": "example",
        "declineReasons": [
          {
            "code": "DEROGATORY_BANKING_RELATIONSHIP",
            "message": "example"
          }
        ],
        "dynamicField": {
          "children": [
            "example"
          ],
          "decisionComponentItemId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "fieldValue": "example",
          "id": "c9a1e2d3-4b5f-6789-0abc-def123456789",
          "parentDynamicFieldId": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
          "schema": "example",
          "selectedOptions": [
            "example"
          ],
          "selectedVariant": "example",
          "selectedVariantKey": "example",
          "sensitiveField": "example"
        },
        "dynamicFields": [
          {
            "children": [
              "example"
            ],
            "decisionComponentItemId": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
            "fieldValue": "example",
            "id": "b6d4e5f6-7a8b-9012-3def-456789012345",
            "parentDynamicFieldId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "schema": "example",
            "selectedOptions": [
              "example"
            ],
            "selectedVariant": "example",
            "selectedVariantKey": "example",
            "sensitiveField": "example"
          }
        ],
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "informationRequests": [
          {
            "applicationId": "c9a1e2d3-4b5f-6789-0abc-def123456789",
            "createdBy": "example",
            "createdDateTime": "2026-01-15T14:30:00Z",
            "description": "example",
            "fulfilledBy": "example",
            "fulfilledDateTime": "2026-01-15T14:30:00Z",
            "fulfillmentAttachmentIds": [
              "d8b2f3e4-5c6a-7890-1bcd-ef2345678901"
            ],
            "fulfillmentResponse": "example",
            "fulfillmentTypes": [
              "DOCUMENT"
            ],
            "id": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
            "status": "FULFILLED",
            "title": "example",
            "type": "ARTICLES_OF_INCORPORATION",
            "updatedDateTime": "2026-01-15T14:30:00Z"
          }
        ],
        "informationRequestStatus": "AWAITING_INFORMATION",
        "kind": "MAINTENANCE_REVIEW",
        "participants": [
          {
            "organization": "example",
            "role": "BANK"
          }
        ],
        "primaryUnderwriter": {
          "name": "Ben Torres",
          "userId": "b6d4e5f6-7a8b-9012-3def-456789012345"
        },
        "processingActivity": {
          "advancedPaymentRate": 0.05,
          "averageAnnualSalesAmount": 0,
          "averageMonthlySalesAmount": 45000,
          "averageTicketAmount": 150,
          "businessToBusinessMix": 0.05,
          "cardNotPresentMix": 0.05,
          "cardPresentMix": 0.05,
          "chargebackRate": 0.05,
          "currency": "USD",
          "customerInitiatedCardNotPresentMix": 0.05,
          "daysInCycle": 0,
          "deliveryTimeframe": 0,
          "exposure": 100000,
          "highestTicketAmount": 2500,
          "merchantInitiatedCardNotPresentMix": 0.05,
          "refundRate": 0.05,
          "riskLevel": "HIGH"
        },
        "queue": "PARTNER",
        "relationshipProcessingActivity": {
          "advancedPaymentRate": 0.05,
          "averageAnnualSalesAmount": 0,
          "averageMonthlySalesAmount": 45000,
          "averageTicketAmount": 150,
          "businessToBusinessMix": 0.05,
          "cardNotPresentMix": 0.05,
          "cardPresentMix": 0.05,
          "chargebackRate": 0.05,
          "currency": "USD",
          "customerInitiatedCardNotPresentMix": 0.05,
          "daysInCycle": 0,
          "deliveryTimeframe": 0,
          "exposure": 100000,
          "highestTicketAmount": 2500,
          "merchantInitiatedCardNotPresentMix": 0.05,
          "refundRate": 0.05,
          "riskLevel": "HIGH"
        },
        "schema": {
          "createdDateTime": "2026-01-15T14:30:00Z",
          "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "underwritingDecisionComponentSchemas": [
            "example"
          ],
          "version": "example"
        },
        "secondaryUnderwriter": {
          "name": "Ben Torres",
          "userId": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
        },
        "stakeholders": [
          {
            "emailAddress": "ben@clacksworth.com",
            "id": "c9a1e2d3-4b5f-6789-0abc-def123456789",
            "ipAddress": "example",
            "ownershipPercentage": 0.05,
            "referenceNumber": 0,
            "roles": [
              "AUTHORIZED"
            ],
            "sensitiveFields": "example"
          }
        ],
        "submissionAttemptedDateTime": "2026-01-15T14:30:00Z",
        "submissionSuccessfulDateTime": "2026-01-15T14:30:00Z",
        "updatedBy": {
          "name": "Ben Torres",
          "type": "APP"
        },
        "updatedDateTime": "2026-01-15T14:30:00Z"
      },
      "events": {
        "items": [
          {
            "applicationId": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
            "createdBy": "example",
            "createdDateTime": "2026-01-15T14:30:00Z",
            "displayInformation": [
              "example"
            ],
            "eventType": "ACCOUNT_CLOSED",
            "id": "e7c3a4b5-6d7e-8901-2cde-f34567890123"
          }
        ],
        "pageInfo": {
          "hasNextPage": true,
          "hasPreviousPage": true
        }
      },
      "id": "b6d4e5f6-7a8b-9012-3def-456789012345",
      "status": "CLOSED"
    }
  }
}
```


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