openapi: 3.2.0
info:
  description: 'This is the OpenAPI spec for Xpansiv Connect API. Documentation: https://developer.xpansiv.com/developer-portal/'
  title: Xpansiv Connect Transfers API
  version: 1.0.0-beta
servers:
- url: https://sandbox.preprod.connect.xpansiv.com/app/api/v1
  description: SANDBOX
- url: https://uat.preprod.connect.xpansiv.com/app/api/v1
  description: UAT
- url: https://connect.xpansiv.com/app/api/v1
  description: PROD
security:
- bearerToken: []
tags:
- name: Transfers
  description: The Transfers APIs allow users to take various actions, both read and write, for their bilateral transaction activity.
paths:
  /transfers/account/{AccountIdentifier}/action/search:
    post:
      tags:
      - Transfers
      operationId: searchTransfers
      summary: Search transfers
      parameters:
      - $ref: '#/components/parameters/AccountIdentifier'
      - $ref: '#/components/parameters/PageNumber'
      - $ref: '#/components/parameters/PageSize'
      - $ref: '#/components/parameters/Include'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                transferIdentifier:
                  type: string
                type:
                  $ref: '#/components/schemas/Ref.TransferType'
                statuses:
                  type: array
                  items:
                    $ref: '#/components/schemas/Ref.TransferStatus'
                registryStatuses:
                  type: array
                  items:
                    $ref: '#/components/schemas/Ref.RegistryTransferStatus'
                lastUpdatedDateFrom:
                  type: string
                  format: date-time
                lastUpdatedDateTo:
                  type: string
                  format: date-time
                counterpartyName:
                  type: string
                programs:
                  type: array
                  items:
                    $ref: '#/components/schemas/Ref.Program'
      responses:
        '200':
          description: List of transfers
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Page'
                - type: object
                  properties:
                    content:
                      type: array
                      items:
                        type: object
                        properties:
                          identifier:
                            type: string
                            description: Unique identifier.
                          counterparty:
                            type: string
                            description: Counterparty name.
                          type:
                            $ref: '#/components/schemas/Ref.TransferType'
                          status:
                            $ref: '#/components/schemas/Ref.TransferStatus'
                          registryStatus:
                            $ref: '#/components/schemas/Ref.RegistryTransferStatus'
                          quantity:
                            type: integer
                            format: int64
                            description: Transfer quantity.
                          dealIds:
                            type: array
                            description: Deal id's associated with the transfer.
                            items:
                              type: string
                          externalTransferIdentifier:
                            type: string
                            description: External identifier if provided by the Xpansiv Connect client.
                          createdDate:
                            type: string
                            format: date-time
                            description: Transfer created date.
                          transferDate:
                            type: string
                            format: date-time
                            description: Transfer date.
                          lastUpdatedDate:
                            type: string
                            format: date-time
                            description: Last updated date.
                          expectedSettlementDate:
                            type: string
                            format: date-time
                            description: Expected settle date.
                          actualSettlementDate:
                            type: string
                            format: date-time
                            description: Actual settle date.
                          registryTransferIdentifier:
                            type: string
                            description: Registry identifier if provided.
                          unitPrice:
                            $ref: '#/components/schemas/Price'
                          showPriceInRegistry:
                            type: boolean
                            description: PJM and NEPOOL registries only.
                          registryTransferPurpose:
                            $ref: '#/components/schemas/Ref.RegistryTransferPurpose'
                          instrument:
                            $ref: '#/components/schemas/Instrument'
                          batchIdentifier:
                            type: string
                            description: Tha batch identifier for the transfer transaction.
                          transferTaxLots:
                            description: Optional property. Use `include` param.
                            type: array
                            items:
                              type: object
                              required:
                              - taxLot
                              properties:
                                taxLot:
                                  $ref: '#/components/schemas/TaxLot'
                                quantity:
                                  type: integer
                                  format: int64
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                    - INVALID_REQUEST
                    - INVALID_PROGRAM
                    - INVALID_TRANSFER_TYPE
                    - INVALID_TRANSFER_STATUS
                    - INVALID_REGISTRY_TRANSFER_STATUS
                    - INVALID_DATE_RANGE
                    - INVALID_PAGE_SIZE
                    - INVALID_PAGE_NUMBER
                  message:
                    type: string
        '401':
          $ref: '#/components/responses/401'
        '500':
          $ref: '#/components/responses/500'
  /transfers/account/{AccountIdentifier}/program/{ProgramCode}/action/create:
    post:
      tags:
      - Transfers
      operationId: createTransfers
      parameters:
      - $ref: '#/components/parameters/AccountIdentifier'
      - $ref: '#/components/parameters/ProgramCode'
      summary: Create transfers
      description: Allows creation transfers in bulk
      requestBody:
        content:
          application/json:
            schema:
              type: object
              description: Registry transfer purpose is required for PJM
              required:
              - counterpartyRegistryName
              - settlementDate
              - transfers
              properties:
                dryRun:
                  description: If true it will only do the validation of the request but not to create the transfers
                  type: boolean
                counterpartyRegistryName:
                  type: string
                registryTransferPurpose:
                  $ref: '#/components/schemas/Ref.RegistryTransferPurpose'
                settlementDate:
                  type: string
                  format: date
                  description: Date when transfers should be settled in EST time zone
                showPriceInRegistry:
                  type: boolean
                  description: Required for PJM and NEPOOL. Price will be communicated to registry on placement.
                notes:
                  type: string
                transfers:
                  type: array
                  items:
                    type: object
                    required:
                    - price
                    - ein
                    - transferData
                    properties:
                      externalTransferIdentifier:
                        type: string
                      ein:
                        type: string
                      unitPrice:
                        $ref: '#/components/schemas/Price'
                      transferData:
                        discriminator:
                          propertyName: transferDataType
                          mapping:
                            STRATEGY: '#/components/schemas/TransferDataStrategy'
                            TAX_LOTS: '#/components/schemas/TransferDataTaxLots'
                        oneOf:
                        - $ref: '#/components/schemas/TransferDataStrategy'
                        - $ref: '#/components/schemas/TransferDataTaxLots'
      responses:
        '200':
          description: Transfers
          content:
            application/json:
              schema:
                type: object
                properties:
                  transfers:
                    type: array
                    items:
                      type: object
                      properties:
                        externalTransferIdentifier:
                          type: string
                        transferIdentifier:
                          type: string
                  batchIdentifier:
                    type: string
                    description: EMA transfer batch identifier
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                    - INVALID_PROGRAM
                    - INVALID_REQUEST
                    - EMPTY_REQUEST
                    - REQUEST_TOO_LARGE
                    - SETTLEMENT_DATE_IN_PAST
                    - SETTLEMENT_DATE_HOLIDAY
                    - SETTLEMENT_DATE_OUTSIDE_TRADING_WINDOW
                    - INVALID_COUNTERPARTY_NAME
                    - INVALID_REGISTRY_TRANSFER_PURPOSE
                    - INVALID_SHOW_PRICE_IN_REGISTRY
                    - INVALID_TRANSFERS
                  message:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          enum:
                          - INVALID_TRANSFER_DATA
                          - INVALID_TAX_LOT_SELECTION_STRATEGY
                          - DUPLICATE_TAX_LOT
                          - DUPLICATE_EIN
                          - INVALID_EIN
                          - QUARANTINED_POSITION
                          - INVALID_TAX_LOT
                          - INVALID_QUANTITY
                          - INVALID_PRICE
                          - UNAVAILABLE_QUANTITY
                        message:
                          type: string
        '401':
          $ref: '#/components/responses/401'
        '500':
          $ref: '#/components/responses/500'
  /transfers/account/{AccountIdentifier}/program/{ProgramCode}/action/cancel:
    post:
      tags:
      - Transfers
      operationId: cancelTransfers
      parameters:
      - $ref: '#/components/parameters/AccountIdentifier'
      - $ref: '#/components/parameters/ProgramCode'
      summary: Cancel transfers
      description: Allows cancellation transfers in bulk
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                dryRun:
                  type: boolean
                notes:
                  type: string
                batchIdentifier:
                  type: string
                transfers:
                  description: Transfer identifiers
                  type: array
                  items:
                    type: string
      responses:
        '200':
          description: Transfers cancelled successfully
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                    - INVALID_PROGRAM
                    - INVALID_REQUEST
                    - EMPTY_REQUEST
                    - REQUEST_TOO_LARGE
                    - TRANSFERS_OR_BATCH
                    - BATCH_REQUIRED_M_RETS
                    - INVALID_TRANSFERS
                    - INVALID_BATCH
                    - INVALID_BATCH_TRANSFERS
                  message:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          enum:
                          - DUPLICATE_TRANSFER
                          - INVALID_TRANSFER
                          - INVALID_TRANSFER_PROGRAM
                          - INVALID_TRANSFER_STATUS
                          - INVALID_TRANSFER_REGISTRY_STATUS
                        message:
                          type: string
        '401':
          $ref: '#/components/responses/401'
        '500':
          $ref: '#/components/responses/500'
  /transfers/account/{AccountIdentifier}/program/{ProgramCode}/action/reject:
    post:
      tags:
      - Transfers
      operationId: rejectTransfers
      parameters:
      - $ref: '#/components/parameters/AccountIdentifier'
      - $ref: '#/components/parameters/ProgramCode'
      summary: Reject transfers
      description: Allows rejection transfers in bulk
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                dryRun:
                  type: boolean
                notes:
                  type: string
                transfers:
                  description: Transfer identifiers
                  type: array
                  items:
                    type: string
      responses:
        '200':
          description: Transfers rejected successfully
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                    - INVALID_PROGRAM
                    - INVALID_REQUEST
                    - EMPTY_REQUEST
                    - REQUEST_TOO_LARGE
                    - INCOMPLETE_M_RETS_BATCH
                    - INVALID_TRANSFERS
                  message:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          enum:
                          - DUPLICATE_TRANSFER
                          - INVALID_TRANSFER
                          - INVALID_TRANSFER_PROGRAM
                          - INVALID_TRANSFER_STATUS
                          - INVALID_TRANSFER_REGISTRY_STATUS
                        message:
                          type: string
        '401':
          $ref: '#/components/responses/401'
        '500':
          $ref: '#/components/responses/500'
  /transfers/account/{AccountIdentifier}/program/{ProgramCode}/action/accept:
    post:
      tags:
      - Transfers
      operationId: acceptTransfers
      parameters:
      - $ref: '#/components/parameters/AccountIdentifier'
      - $ref: '#/components/parameters/ProgramCode'
      summary: Accept transfers
      description: Allows acceptance transfers in bulk
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - transfers
              properties:
                dryRun:
                  type: boolean
                notes:
                  type: string
                transfers:
                  description: Transfer identifiers
                  type: array
                  items:
                    type: object
                    required:
                    - transferIdentifier
                    - price
                    properties:
                      transferIdentifier:
                        type: string
                      externalTransferIdentifier:
                        type: string
                      price:
                        $ref: '#/components/schemas/Price'
      responses:
        '200':
          description: Transfers accepted successfully
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                    - INVALID_PROGRAM
                    - INVALID_REQUEST
                    - EMPTY_REQUEST
                    - REQUEST_TOO_LARGE
                    - SETTLEMENT_DATE_IN_PAST
                    - SETTLEMENT_DATE_HOLIDAY
                    - SETTLEMENT_DATE_OUTSIDE_TRADING_WINDOW
                    - INCOMPLETE_M_RETS_BATCH
                    - INVALID_TRANSFERS
                  message:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          enum:
                          - DUPLICATE_TRANSFER
                          - INVALID_TRANSFER
                          - INVALID_TRANSFER_PROGRAM
                          - INVALID_PRICE
                          - INVALID_TRANSFER_STATUS
                          - INVALID_TRANSFER_REGISTRY_STATUS
                        message:
                          type: string
        '401':
          $ref: '#/components/responses/401'
        '500':
          $ref: '#/components/responses/500'
components:
  schemas:
    Ref.TaxLotSelectionStrategy:
      type: string
      description: Ref.Data.TAX_LOT_SELECTION_STRATEGY
    Instrument:
      oneOf:
      - $ref: '#/components/schemas/CarbonInstrument'
      - $ref: '#/components/schemas/RecInstrument'
      - $ref: '#/components/schemas/ResourceInstrument'
    RecInstrument:
      allOf:
      - $ref: '#/components/schemas/BaseInstrument'
      - type: object
        required:
        - generator
        properties:
          fuelType:
            $ref: '#/components/schemas/FuelType'
          stateEligibilities:
            type: array
            description: Optional property. Use `include` param.
            items:
              type: object
              description: Object to hold full state eligibility information - type of eligibility and name
              properties:
                name:
                  type: string
                  description: Name of the state eligibility.
                type:
                  $ref: '#/components/schemas/Ref.StateEligibilityType'
          voluntaryEligibilities:
            type: array
            description: Optional property. Use `include` param.
            items:
              $ref: '#/components/schemas/VoluntaryEligibility'
          generator:
            $ref: '#/components/schemas/Generator'
    Market:
      properties:
        name:
          type: string
          description: Name of the market.
        apiCode:
          type: string
          description: API code for market execution venue.
        applicableExecutionVenues:
          type: array
          items:
            $ref: '#/components/schemas/Ref.ExecutionVenue'
        applicablePrograms:
          type: array
          items:
            $ref: '#/components/schemas/Ref.Program'
    MarketModelInstrumentPrice:
      properties:
        amount:
          type: number
          format: double
          description: Amount.
        currency:
          $ref: '#/components/schemas/Ref.Currency'
        lastUpdatedDate:
          type: string
          format: date-time
          description: Last updated date-time.
    Ref.ResourceProgram:
      type: string
      description: Ref.Data.RESOURCE_PROGRAM
    CarbonInstrument:
      allOf:
      - $ref: '#/components/schemas/BaseInstrument'
      - type: object
        required:
        - project
        properties:
          serialNumber:
            type: string
          issuanceCertifications:
            type: array
            description: Optional property. Use `include` param.
            items:
              $ref: '#/components/schemas/IssuanceCertification'
          projectCertifications:
            type: array
            description: Optional property. Use `include` param.
            items:
              $ref: '#/components/schemas/ProjectCertification'
          reportingPeriodStart:
            type: string
            format: date-time
            description: Reporting period start date.
          reportingPeriodEnd:
            type: string
            format: date-time
            description: Reporting period end date.
          project:
            $ref: '#/components/schemas/Project'
    ProjectCertification:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/Ref.Certification'
        projectCertificationDateRanges:
          type: array
          items:
            type: object
            properties:
              certificationStart:
                type: string
                format: date-time
                description: The project certification start date.
              certificationEnd:
                type: string
                format: date-time
                description: The project certification end date.
    BaseInstrument:
      type: object
      required:
      - type
      - ein
      - program
      - vintage
      - creditType
      properties:
        type:
          $ref: '#/components/schemas/Ref.InstrumentType'
        id:
          type: integer
          format: int64
          description: Unique Xpansiv Connect identifier.
        ein:
          type: string
          description: 'Environment Instrument Number. Unique identifier associated with an issuance of credits from a given project,  vintage, technology/fuel type and associated certification(s)/eligibility(s). An EIN is associated with a  position and a position will never be associated with more than 1 EIN.

            '
        description:
          type: string
          description: 'The Xpansiv Connect description associated with the instrument providing information regarding location,  vintage, fuel type and certifications.

            '
        program:
          $ref: '#/components/schemas/Ref.Program'
        vintage:
          $ref: '#/components/schemas/Vintage'
        markets:
          type: array
          description: Optional property. Use `include` param.
          items:
            $ref: '#/components/schemas/InstrumentMarket'
        creditType:
          type: string
          description: The type of the credit.
      discriminator:
        propertyName: type
        mapping:
          CARBON: '#/components/schemas/CarbonInstrument'
          REC: '#/components/schemas/RecInstrument'
          RESOURCE_PROJECT: '#/components/schemas/ResourceInstrument'
    Price:
      type: object
      required:
      - currency
      - amount
      properties:
        currency:
          $ref: '#/components/schemas/Ref.Currency'
        amount:
          type: number
          description: The numeric value of the price
          minimum: 0
    InstrumentMarket:
      properties:
        market:
          $ref: '#/components/schemas/Market'
        marketModelInstrument:
          $ref: '#/components/schemas/MarketModelInstrument'
    Ref.VoluntaryEligibilityType:
      type: string
      description: The type of the voluntary eligibility. Ref.Data.REC_VOLUNTARY_ELIGIBILITY
    Ref.GeneratorStatus:
      type: string
      description: The status of the generator in the registry. Ref.Data.GENERATOR_STATUS
    Ref.ResourceInType:
      type: string
      description: Ref.Data.RESOURCE_INPUT_TYPE
    NotAuthorizedError:
      type: object
      properties:
        message:
          type: string
    Ref.ResourceOutType:
      type: string
      description: Ref.Data.RESOURCE_OUTPUT_TYPE
    Ref.ExecutionVenue:
      type: string
      description: Ref.Data.EXECUTION_VENUE
    Ref.CarbonProgram:
      type: string
      description: Ref.Data.CARBON_PROGRAM
    Generator:
      allOf:
      - $ref: '#/components/schemas/Resource'
      - type: object
        properties:
          program:
            $ref: '#/components/schemas/Ref.RecProgram'
          registryAssignedId:
            type: string
            description: The registry assigned identifier for the generator.
          status:
            $ref: '#/components/schemas/Ref.GeneratorStatus'
          siteCode:
            type: string
            description: The Site Code of the generator if provided by the registry.
          unitName:
            type: string
            description: The Unit Name of the generator in the registry.
          controlArea:
            type: string
            description: The Control Area that the generator is located in.
          parentCompanyName:
            type: string
            description: The Parent Company Name of the generator if provided by the registry.
          powerCompanyName:
            type: string
            description: The Power Company Name of the generator if provided by the registry.
          powerCompanyCode:
            type: string
            description: The Power Company Code of the generator if provided by the registry.
          ownerName:
            type: string
            description: The Owner Name of the generator if provided by the registry
          ownershipType:
            type: string
            description: The Ownership Type of the generator if provided by the registry.
          countyName:
            type: string
            description: The County Name locatio of the generator if provided by the registry.
          stateProvince:
            $ref: '#/components/schemas/Ref.StateProvince'
          country:
            $ref: '#/components/schemas/Ref.Country'
          contactInfo:
            type: string
            description: Contact Information for the generator if provided by the registry.
          registryAcctHolderName:
            type: string
            description: The Registry Account Holder name of the generator if provided by the registry.
          commencedDt:
            type: string
            format: date-time
            description: The Commenced Operation Date of the generator if provided by the registry.
          nameplateCapacity:
            type: number
            format: double
            description: The Nameplate Capacity of the generator if provided by the registry.
          facNoncompetitiveCertData:
            type: string
          fuelTypes:
            type: array
            description: Additional information about a generator if it is multi-fuel. Optional property. Use `include` param.
            items:
              title: Fuel Type Eligibility aggregation
              type: object
              required:
              - fuelType
              properties:
                fuelType:
                  $ref: '#/components/schemas/FuelType'
                stateEligibilities:
                  type: array
                  items:
                    $ref: '#/components/schemas/StateEligibility'
                voluntaryEligibilities:
                  type: array
                  items:
                    $ref: '#/components/schemas/VoluntaryEligibility'
    Project:
      allOf:
      - $ref: '#/components/schemas/Resource'
      - type: object
        required:
        - programs
        properties:
          programs:
            type: array
            items:
              type: object
              title: ProjectProgram
              required:
              - program
              - registryAssignedId
              - status
              - creditType
              - projectType
              properties:
                program:
                  $ref: '#/components/schemas/Ref.CarbonProgram'
                programName:
                  type: string
                  description: Registry name.
                registryAssignedId:
                  type: string
                  description: ID assigned by the registry.
                registryAccountHolderName:
                  type: string
                  description: Name of the registry account holder.
                status:
                  $ref: '#/components/schemas/Ref.ProjectRegistryStatus'
                creditType:
                  $ref: '#/components/schemas/Ref.CreditType'
                projectType:
                  $ref: '#/components/schemas/Ref.ProjectType'
                baselineMethodologies:
                  type: array
                  items:
                    $ref: '#/components/schemas/Ref.BaselineMethodology'
                creditingPeriodBegin:
                  type: string
                  format: date-time
                  description: Begin date for credit reporting.
                creditingPeriodEnd:
                  type: string
                  format: date-time
                  description: End date for credit reporting.
          description:
            type: string
            description: The full description from the registry.
          status:
            $ref: '#/components/schemas/Ref.ProjectStatus'
          country:
            $ref: '#/components/schemas/Ref.Country'
          stateProvince:
            type: string
            description: State or Province
          city:
            type: string
            description: City.
          location:
            $ref: '#/components/schemas/Location'
          annualAverageOffsetQty:
            type: integer
            format: int64
            description: Annual average offset quantity.
          projectCertifications:
            type: array
            description: Optional property. Use `include` param.
            items:
              $ref: '#/components/schemas/ProjectCertification'
          issuanceCertifications:
            type: array
            description: Optional property. Use `include` param.
            items:
              $ref: '#/components/schemas/IssuanceCertification'
    Ref.StateEligibilityType:
      type: string
      description: The type of the state eligibility. Ref.Data.REC_STATE_ELIGIBILITY
    Location:
      title: Resource location
      type: object
      properties:
        latitude:
          type: number
          format: double
          description: Latitude.
        longitude:
          type: number
          format: double
          description: Longitude.
    Page:
      type: object
      required:
      - page
      - size
      - totalPages
      - totalElements
      properties:
        page:
          type: integer
          format: int32
        size:
          type: integer
          format: int32
        totalPages:
          type: integer
          format: int32
        totalElements:
          type: integer
          format: int64
    ResourceInstrument:
      allOf:
      - $ref: '#/components/schemas/BaseInstrument'
      - type: object
        required:
        - resourceProject
        properties:
          serialNumber:
            type: string
          inType:
            $ref: '#/components/schemas/Ref.ResourceInType'
          outType:
            $ref: '#/components/schemas/Ref.ResourceOutType'
          resourceProject:
            $ref: '#/components/schemas/ResourceProject'
    InternalServerError:
      type: object
      properties:
        message:
          type: string
    Ref.FuelType:
      type: string
      description: Ref.Data.REC_FUEL_TYPE
    Ref.TransferStatus:
      type: string
      description: Ref.Data.TRANSFER_STATUS
    TaxLot:
      type: object
      description: A Tax Lot represents the incoming activity that resulted in the creation or increase of a position against an EIN. The types of activities represented by Tax Lots are; imported positions (at account linking); incoming settled bilateral transfers; or credit issuance. Tax Lot is associated with a Position, where 1 or more Tax Lots make up the available quantity for a single Position
      properties:
        id:
          type: integer
          format: int64
          description: The unique identifier for the tax lot
        name:
          type: string
          description: The name of the tax lot, normally made up of tax lot type and established date
        establishedDate:
          type: string
          format: date-time
          description: The timestamp for when the tax lot was established, meaning when the transaction that created the tax lot was accepted in XC
        establishQuantity:
          type: integer
          format: int64
          description: The original quantity of credits that created the tax lot. Optional property. Use `include` param.
        pricePaid:
          $ref: '#/components/schemas/Price'
        availableQuantity:
          type: integer
          format: int64
          description: The quantity available of the tax lot for transfer or retirement
        encumberedQuantity:
          type: integer
          format: int64
          description: The quantity encumbered of the tax lot on an execution venue integrated with XC
        unsettledQuantity:
          type: integer
          format: int64
          description: The quantity unsettled of the tax lot. This can represent a quantity that is in a bilateral transaction, buy or sell, that is pending and not yet settled in the registry.
        estimatedMarketPrice:
          type: number
          description: The estimated price associated with the highest value market this tax lot has a certification with  where prices have been uploaded from the CBL Exchange. Optional property. Use `include` param.
        estimatedMarketValue:
          type: number
          description: Using the Estimated Market Price, this represents the estimated market value of the tax lot based on the tax lot position quantity. Optional property. Use `include` param.
        estimatedGainLoss:
          type: number
          description: Utilizing both Price Paid and Estimated Market Price against tax lot quantity to determine if there was a financial gain or loss for this tax lot. Optional property. Use `include` param.
        previousCounterparty:
          type: string
          description: The registry name of the counterparty that transferred the credits of this tax lot to the XC client. Optional property. Use `include` param.
        externalTradeId:
          type: string
          description: An external trade/transaction identifier as provided by the XC client for this position. Optional property. Use `include` param.
        dealId:
          type: string
          description: A deal Identifier as provided by the XC client for this position if associated with a forward deal delivery. Optional property. Use `include` param.
    TransferDataTaxLots:
      type: object
      title: TransferDataTaxLots
      required:
      - transferDataType
      - taxLots
      properties:
        transferDataType:
          type: string
          default: TAX_LOTS
        taxLots:
          type: array
          items:
            type: object
            required:
            - taxLotId
            - quantity
            properties:
              taxLotId:
                type: integer
                format: int64
              quantity:
                type: integer
                format: int64
                minimum: 1
    Ref.RecProgram:
      type: string
      description: Ref.Data.REC_PROGRAM
    StateEligibility:
      type: object
      description: Object to hold full state eligibility information - type of eligibility, extendable with other information
      properties:
        name:
          type: string
          description: Name of the state eligibility.
        type:
          $ref: '#/components/schemas/Ref.StateEligibilityType'
        stateIdentifier:
          type: string
          description: This is the identifier of the eligibility from the registry
    MarketModelInstrument:
      properties:
        ein:
          type: string
          description: 'Environment Instrument Number. Unique identifier associated with an issuance of credits from a given project,  vintage, technology/fuel type and associated certification(s)/eligibility(s).  An EIN is associated with a position and a position will never be associated with more than 1 EIN.

            '
        description:
          type: string
          description: Description.
        price:
          $ref: '#/components/schemas/MarketModelInstrumentPrice'
    Ref.ResourceProjectStatus:
      type: string
      description: Ref.Data.RESOURCE_PROJECT_STATUS
    Ref.TransferType:
      type: string
      description: Ref.Data.TRANSFER_ACTION_TYPE
    Ref.ProjectType:
      type: string
      description: The project type. Ref.Data.CARBON_PROJECT_TYPE
    ResourceProject:
      allOf:
      - $ref: '#/components/schemas/Resource'
      - type: object
        required:
        - programs
        properties:
          programs:
            type: array
            items:
              type: object
              title: ResourceProjectProgram
              required:
              - program
              - registryAssignedId
              properties:
                program:
                  $ref: '#/components/schemas/Ref.ResourceProgram'
                programName:
                  type: string
                registryAssignedId:
                  type: string
          status:
            $ref: '#/components/schemas/Ref.ResourceProjectStatus'
          country:
            $ref: '#/components/schemas/Ref.Country'
          accountName:
            type: string
          classification1:
            type: string
          classification2:
            type: string
          classification3:
            type: string
          childResourceProject:
            $ref: '#/components/schemas/ChildResourceProject'
          inOutTypes:
            type: array
            items:
              type: object
              required:
              - inType
              - outType
              properties:
                inType:
                  $ref: '#/components/schemas/Ref.ResourceInType'
                outType:
                  $ref: '#/components/schemas/Ref.ResourceOutType'
          typeName:
            type: string
    FuelType:
      type: object
      properties:
        name:
          type: string
          description: The fuel type associated with the underlying asset.
        type:
          $ref: '#/components/schemas/Ref.FuelType'
        fuelSource:
          type: string
          description: The registry fuel source associated with the fuel type (registry-dependent).
    Ref.InstrumentType:
      type: string
      description: REC or CARBON. Ref.Data.INSTRUMENT_TYPE
    Ref.Country:
      type: string
      description: Ref.Data.COUNTRY
    Ref.ProjectStatus:
      type: string
      description: Ref.Data.PROJECT_STATUS
    Ref.Certification:
      type: string
      description: Certification code. Ref.Data.CARBON_CERTIFICATION
    Ref.RegistryTransferStatus:
      type: string
      description: Ref.Data.TRANSFER_REGISTRY_STATUS
    IssuanceCertification:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/Ref.Certification'
        vintageYears:
          type: array
          description: Vintage years.
          items:
            type: integer
            format: int32
    VoluntaryEligibility:
      type: object
      description: Object to hold full voluntary eligibility information - type of eligibility, effective date, expiration, extendable with other information
      properties:
        name:
          type: string
          description: The name of the registry voluntary eligibility.
        type:
          $ref: '#/components/schemas/Ref.VoluntaryEligibilityType'
        effectiveDate:
          type: string
          format: date-time
          description: The effective date of the eligibility.
        expirationDate:
          type: string
          format: date-time
          description: the expiration date of the eligibility.
    Vintage:
      type: object
      required:
      - year
      properties:
        year:
          type: integer
          format: int32
          description: Vintage year.
        month:
          type: integer
          format: int32
          description: Vintage month.
    TransferDataStrategy:
      type: object
      required:
      - transferDataType
      - taxLotSelectionStrategy
      - quantity
      properties:
        transferDataType:
          type: string
          default: STRATEGY
        taxLotSelectionStrategy:
          $ref: '#/components/schemas/Ref.TaxLotSelectionStrategy'
        quantity:
          type: integer
          format: int64
          minimum: 1
    Ref.StateProvince:
      type: string
      description: Ref.Data.STATE_PROVINCE
    Ref.Program:
      type: string
      description: Ref.Data.PROGRAM
    Ref.ProjectRegistryStatus:
      type: string
      description: The registry status of the project. Ref.Data.PROJECT_REGISTRY_STATUS
    Ref.BaselineMethodology:
      type: string
      description: Ref.Data.BASELINE_METHODOLOGY
    Ref.RegistryTransferPurpose:
      type: string
      description: Ref.Data.PJM_TRANSFER_PURPOSE
    Resource:
      type: object
      required:
      - name
      properties:
        id:
          type: integer
          format: int64
          description: The unique XC db identifier for the project or generator.
        upn:
          type: string
          description: 'Universal Project Identifier. The unique identifier assigned by Xpansiv Connect to every resource across all registries that  have integrated with the Xpansiv Connect platform.

            '
        name:
          type: string
          description: The registry assigned name of the project or generator.
    ChildResourceProject:
      allOf:
      - $ref: '#/components/schemas/Resource'
      - type: object
        properties:
          accountName:
            type: string
          inOutTypes:
            type: array
            items:
              type: object
              required:
              - inType
              - outType
              properties:
                inType:
                  $ref: '#/components/schemas/Ref.ResourceInType'
                outType:
                  $ref: '#/components/schemas/Ref.ResourceOutType'
          programs:
            type: array
            items:
              type: object
              title: ChildResourceProjectProgram
              required:
              - program
              - registryAssignedId
              properties:
                program:
                  $ref: '#/components/schemas/Ref.ResourceProgram'
                programName:
                  type: string
                registryAssignedId:
                  type: string
    Ref.CreditType:
      type: string
      description: The type of the credit. Ref.Data.CARBON_CREDIT_TYPE
    Ref.Currency:
      description: Ref.Data.CURRENCY
      type: string
      minLength: 3
      example: USD
  responses:
    '500':
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/InternalServerError'
    '401':
      description: Not authorized error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/NotAuthorizedError'
  parameters:
    AccountIdentifier:
      description: Account identifier
      name: AccountIdentifier
      example: 098B0A25
      in: path
      required: true
      schema:
        type: string
    PageSize:
      name: size
      in: query
      required: false
      schema:
        type: integer
        format: int32
    ProgramCode:
      name: ProgramCode
      description: Any program code. Ref.Data.PROGRAM
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/Ref.Program'
    Include:
      name: include
      description: Comma-separated values from optional response fields
      in: query
      required: false
      schema:
        type: string
    PageNumber:
      name: page
      in: query
      required: false
      schema:
        type: integer
        format: int32
  securitySchemes:
    bearerToken:
      type: http
      scheme: bearer
      bearerFormat: JWT