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

# Get a merchant application

> One application submitted through you: the business, its stage and its history. Full SSNs, tax ids and bank account numbers are never included, only their last four digits.



## OpenAPI

````yaml /api-reference/openapi.json get /applications/{id}
openapi: 3.1.1
info:
  title: Mojo Payments API
  description: >-
    Invoices, deposits, payments and locations for merchants; the merchant
    portfolio for reseller partners. Authenticate with an API key: exchange it
    at `POST /oauth/token` for a 10-minute access token, and send that as
    `Authorization: Bearer <token>`. Guides:
    https://kb.paymentsmojo.com/developers/overview
  version: '1'
servers:
  - url: https://api.paymentsmojo.com
security:
  - Bearer: []
tags:
  - name: Reseller portfolio
  - name: Invoice payments
  - name: Authentication
  - name: Locations
  - name: Merchant accounts (MIDs)
  - name: Merchant applications
  - name: POS Gateway
  - name: Deposits
paths:
  /applications/{id}:
    get:
      tags:
        - Merchant applications
      summary: Get a merchant application
      description: >-
        One application submitted through you: the business, its stage and its
        history. Full SSNs, tax ids and bank account numbers are never included,
        only their last four digits.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationDetail'
        '401':
          description: >-
            No access token, or it expired or its key was revoked. Get a new
            token.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: >-
            The key doesn't have the permission this needs, or the organization
            is suspended.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '404':
          description: Not Found
        '429':
          description: Too many requests. Wait and try again.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
components:
  schemas:
    ApplicationDetail:
      required:
        - summary
        - entityType
        - incorporationState
        - businessStartDate
        - businessDescription
        - website
        - businessPhone
        - addressLine1
        - addressLine2
        - city
        - state
        - postalCode
        - timeZone
        - taxIdLast4
        - contactPhone
        - bankName
        - routingNumber
        - accountNumberLast4
        - averageTicket
        - highTicket
        - cardPresentPercent
        - reviewNotes
        - decisionReason
        - sensitiveDataPurgedAt
        - owners
      type: object
      properties:
        summary:
          $ref: '#/components/schemas/ApplicationSummary'
        entityType:
          type: string
        incorporationState:
          type:
            - 'null'
            - string
        businessStartDate:
          type:
            - 'null'
            - string
          format: date
        businessDescription:
          type: string
        website:
          type:
            - 'null'
            - string
        businessPhone:
          type: string
        addressLine1:
          type: string
        addressLine2:
          type:
            - 'null'
            - string
        city:
          type: string
        state:
          type: string
        postalCode:
          type: string
        timeZone:
          type: string
        taxIdLast4:
          type:
            - 'null'
            - string
        contactPhone:
          type: string
        bankName:
          type:
            - 'null'
            - string
        routingNumber:
          type:
            - 'null'
            - string
        accountNumberLast4:
          type:
            - 'null'
            - string
        averageTicket:
          pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$
          type:
            - number
            - string
          format: double
        highTicket:
          pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$
          type:
            - number
            - string
          format: double
        cardPresentPercent:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - integer
            - string
          format: int32
        reviewNotes:
          type:
            - 'null'
            - string
        decisionReason:
          type:
            - 'null'
            - string
        sensitiveDataPurgedAt:
          type:
            - 'null'
            - string
          format: date-time
        owners:
          type: array
          items:
            $ref: '#/components/schemas/ApplicationOwnerView'
        changesRequest:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/ApplicationChangesRequest'
        activity:
          type:
            - 'null'
            - array
          items:
            $ref: '#/components/schemas/ApplicationActivity'
        applicantNotes:
          type:
            - 'null'
            - string
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
        title:
          type: string
          description: A short summary, e.g. "Check the request".
        status:
          type: integer
          format: int32
        detail:
          type: string
          description: What to change, in plain words.
        errors:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: Field validation messages, by field (400 only).
      description: What went wrong (RFC 9457).
    ApplicationSummary:
      required:
        - id
        - organizationId
        - resellerOrganizationId
        - resellerName
        - stage
        - dbaName
        - legalName
        - contactName
        - contactEmail
        - monthlyVolume
        - submittedAt
        - stageChangedAt
      type: object
      properties:
        id:
          type: string
          format: uuid
        organizationId:
          type: string
          format: uuid
        resellerOrganizationId:
          type:
            - 'null'
            - string
          format: uuid
        resellerName:
          type:
            - 'null'
            - string
        stage:
          type: string
        dbaName:
          type: string
        legalName:
          type: string
        contactName:
          type: string
        contactEmail:
          type: string
        monthlyVolume:
          pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$
          type:
            - number
            - string
          format: double
        submittedAt:
          type: string
          format: date-time
        stageChangedAt:
          type: string
          format: date-time
    ApplicationOwnerView:
      required:
        - id
        - firstName
        - lastName
        - title
        - ownershipPercent
        - email
        - phone
        - addressLine1
        - city
        - state
        - postalCode
        - ssnLast4
        - hasDateOfBirth
        - hasDriversLicense
        - driversLicenseState
      type: object
      properties:
        id:
          type: string
          format: uuid
        firstName:
          type: string
        lastName:
          type: string
        title:
          type: string
        ownershipPercent:
          pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$
          type:
            - number
            - string
          format: double
        email:
          type: string
        phone:
          type: string
        addressLine1:
          type: string
        city:
          type: string
        state:
          type: string
        postalCode:
          type: string
        ssnLast4:
          type:
            - 'null'
            - string
        hasDateOfBirth:
          type: boolean
        hasDriversLicense:
          type: boolean
        driversLicenseState:
          type:
            - 'null'
            - string
    ApplicationChangesRequest:
      required:
        - message
        - requestedAt
        - requestedByName
        - expiresAt
      type: object
      properties:
        message:
          type: string
        requestedAt:
          type: string
          format: date-time
        requestedByName:
          type: string
        expiresAt:
          type: string
          format: date-time
    ApplicationActivity:
      required:
        - kind
        - detail
        - byName
        - at
      type: object
      properties:
        kind:
          type: string
        detail:
          type:
            - 'null'
            - string
        byName:
          type: string
        at:
          type: string
          format: date-time
  securitySchemes:
    Bearer:
      type: http
      description: >-
        An access token from POST /oauth/token (your API key's id and secret).
        It lasts 10 minutes.
      scheme: bearer
      bearerFormat: JWT

````

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