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

# Access Credit Score History

> Monitors historical FRISK®, PAYCE®, DBT, and Z-Score metrics over time.

<Note>
  Use the [**<u>Login</u>**<u> endpoint</u>](/api-reference/user/logs-a-user-in) to retrieve the **`SessionKey`**, then include it in the **Authorization** field for authentication.
</Note>


## OpenAPI

````yaml get /v1/Business/CreditScoreHistory
openapi: 3.0.0
info:
  version: v2
  title: Credit Risk Monitor API
servers:
  - url: https://api.creditriskmonitor.com
security: []
paths:
  /v1/Business/CreditScoreHistory:
    get:
      tags:
        - Business
      summary: Gets the FRISK, PAYCE, DBT, and Z-Score history for a business.
      operationId: Business_GetCreditScoreHistory
      parameters:
        - name: id
          in: query
          description: Business Id
          required: false
          schema:
            format: int32
            type: integer
        - name: StartDate
          in: query
          description: Staring timeframe to return scores for
          required: false
          schema:
            type: string
            format: date-time
        - name: EndDate
          in: query
          description: Ending timeframe to return scores for
          required: false
          schema:
            type: string
            format: date-time
        - name: CustomerId
          in: query
          description: >-
            If you are a Trade Provider you can use your CustomerId to idenfity
            a Business with the CustomerId parameter.
          required: false
          schema:
            type: string
        - name: SupplierId
          in: query
          description: >-
            If you have a Supplier List you can use your SupplierId to identify
            a Business with the SupplierId parameter.
          required: false
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/APIResponseContainer_APICreditScoreHistoryCollection_
            text/json:
              schema:
                $ref: >-
                  #/components/schemas/APIResponseContainer_APICreditScoreHistoryCollection_
            text/html:
              schema:
                $ref: >-
                  #/components/schemas/APIResponseContainer_APICreditScoreHistoryCollection_
            application/xml:
              schema:
                $ref: >-
                  #/components/schemas/APIResponseContainer_APICreditScoreHistoryCollection_
            text/xml:
              schema:
                $ref: >-
                  #/components/schemas/APIResponseContainer_APICreditScoreHistoryCollection_
      security:
        - Bearer: []
components:
  schemas:
    APIResponseContainer_APICreditScoreHistoryCollection_:
      description: ''
      type: object
      properties:
        Success:
          description: ''
          type: boolean
        Data:
          description: ''
          type: array
          items:
            $ref: '#/components/schemas/APICreditScoreHistory'
        ErrorCode:
          description: ''
          type: string
    APICreditScoreHistory:
      description: Credit Scores
      type: object
      properties:
        FRISKScore:
          format: int32
          description: FRISK Score
          type: integer
        DBTScore:
          format: int32
          description: DBT Index
          type: integer
        ZScore:
          format: double
          description: Altman Z-score
          type: number
        PAYCEScore:
          format: int32
          description: PAYCE Score
          type: integer
        Year:
          format: int32
          description: Year for these scores
          type: integer
        Month:
          format: int32
          description: Month for these scores
          type: integer
        Quarter:
          format: int32
          description: Quarter for these scores
          type: integer
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      description: >-
        Enter the Session Key with the `Bearer ` prefix, e.g. "Bearer
        abcde12345".

````