FOLIO

FOLIO Transactions API

The transactions API from FOLIO — 6 operation(s) for transactions.

Documentation GitHub OpenAPI

Operations 8

POST /transactions/{dcbTransactionId} Create circulation request #

PUT /transactions/{dcbTransactionId} Update transaction details #

GET /transactions/{dcbTransactionId}/status Get transaction status by id #

PUT /transactions/{dcbTransactionId}/status Update transaction status #

GET /transactions/status Get transaction status list #

PUT /transactions/{dcbTransactionId}/renew Renew item loan by transaction id #

PUT /transactions/{dcbTransactionId}/block-renewal Block item renewal by transaction id #

PUT /transactions/{dcbTransactionId}/unblock-renewal Unblock item renewal by transaction id #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/folio:folio-transactions-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Folio Transactions API
  version: 1.0.0
  description: 'Operations tagged transactions across 3 of this provider''s published API definitions: folio-mod-dcb-dcb-transaction-openapi.json, folio-edge-dcb-openapi.yml, folio-mod-dcb-dcb-transaction-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: /dcbService/
tags:
- name: Transactions
paths:
  /transactions/{dcbTransactionId}:
    description: DCB Circulation Transaction endpoint
    post:
      operationId: createCirculationRequest
      tags:
      - Transactions
      parameters:
      - $ref: '#/components/parameters/dcbTransactionId'
      requestBody:
        $ref: '#/components/requestBodies/DCBTransaction'
      responses:
        '201':
          $ref: '#/components/responses/TransactionStatusResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '409':
          $ref: '#/components/responses/Conflict'
        '500':
          $ref: '#/components/responses/InternalServerError'
      summary: Create circulation request
      x-summary-source: derived
    put:
      description: Update the details of a transaction
      operationId: updateTransactionDetails
      tags:
      - Transactions
      parameters:
      - $ref: '#/components/parameters/dcbTransactionId'
      requestBody:
        $ref: '#/components/requestBodies/DcbUpdateTransaction'
      responses:
        '204':
          description: Transaction updated successfully
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      summary: Update transaction details
      x-summary-source: derived
  /transactions/{dcbTransactionId}/status:
    parameters:
    - $ref: '#/components/parameters/dcbTransactionId'
    get:
      description: Get transaction status across circulation institutions
      operationId: getTransactionStatusById
      tags:
      - Transactions
      responses:
        '200':
          $ref: '#/components/responses/TransactionStatusResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      summary: Get transaction status by id
      x-summary-source: derived
    put:
      description: Update transaction status across circulation institutions
      operationId: updateTransactionStatus
      tags:
      - Transactions
      requestBody:
        $ref: '#/components/requestBodies/TransactionStatusBody'
      responses:
        '200':
          $ref: '#/components/responses/TransactionStatusResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      summary: Update transaction status
      x-summary-source: derived
  /transactions/status:
    parameters:
    - $ref: '#/components/parameters/fromDate'
    - $ref: '#/components/parameters/toDate'
    - $ref: '#/components/parameters/pageNumber'
    - $ref: '#/components/parameters/pageSize'
    get:
      description: Get a list of updated transactions between from date and to date with optional filtering and pagination
      operationId: getTransactionStatusList
      tags:
      - Transactions
      responses:
        '200':
          $ref: '#/components/responses/TransactionStatusResponseCollection'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
        '500':
          $ref: '#/components/responses/InternalServerError'
      summary: Get transaction status list
      x-summary-source: derived
  /transactions/{dcbTransactionId}/renew:
    parameters:
    - $ref: '#/components/parameters/dcbTransactionId'
    put:
      description: Increment the renew loan count and returned transaction status with renewal details
      operationId: renewItemLoanByTransactionId
      tags:
      - Transactions
      responses:
        '200':
          $ref: '#/components/responses/TransactionStatusResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      summary: Renew item loan by transaction id
      x-summary-source: derived
  /transactions/{dcbTransactionId}/block-renewal:
    parameters:
    - $ref: '#/components/parameters/dcbTransactionId'
    put:
      description: Set the renewal count for the item in DCB transaction to maximum allowed renewals
      operationId: blockItemRenewalByTransactionId
      tags:
      - Transactions
      responses:
        '204':
          description: Block renewal for the item in dcb transaction
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      summary: Block item renewal by transaction id
      x-summary-source: derived
  /transactions/{dcbTransactionId}/unblock-renewal:
    parameters:
    - $ref: '#/components/parameters/dcbTransactionId'
    put:
      description: Set the renewal count for the item in DCB transaction to zero
      operationId: unblockItemRenewalByTransactionId
      tags:
      - Transactions
      responses:
        '204':
          description: Unblock renewal for the item in DCB transaction
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      summary: Unblock item renewal by transaction id
      x-summary-source: derived
components:
  responses:
    UnprocessableEntity:
      description: Validation errors
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Errors'
    TransactionStatusResponseCollection:
      description: List of TransactionResponse object
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/TransactionStatusResponseCollection'
    TransactionStatusResponse:
      description: TransactionStatusResponse object
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/TransactionStatusResponse'
    Conflict:
      description: Validation errors
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Errors'
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    BadRequest:
      description: Bad request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    TransactionStatus:
      type: object
      properties:
        status:
          type: string
          enum:
          - CREATED
          - OPEN
          - AWAITING_PICKUP
          - ITEM_CHECKED_OUT
          - ITEM_CHECKED_IN
          - EXPIRED
          - CLOSED
          - CANCELLED
          - ERROR
        message:
          type: string
        context:
          type: object
          description: Optional context for the transaction status update
          properties:
            claimedReturnedResolution:
              $ref: '#/components/schemas/ClaimedReturnedResolution'
    Parameters:
      description: List of key/value parameters of an error
      type: array
      items:
        $ref: '#/components/schemas/Parameter'
      additionalProperties: false
    DcbPatron:
      description: Patron metadata required for the transaction
      type: object
      properties:
        id:
          description: The unique identifier for the patron making the request as known in the requesting library
          $ref: '#/components/schemas/uuid'
        group:
          description: The patron group associated with the requesting patron
          type: string
        barcode:
          description: The barcode of the patron
          type: string
        localNames:
          description: 'The local names for the patron, for example: "[John, Johnny, Doe]"'
          type: string
    TransactionStatusResponse:
      allOf:
      - $ref: '#/components/schemas/TransactionStatus'
      - $ref: '#/components/schemas/DcbTransaction'
    TransactionStatusResponseCollection:
      type: object
      properties:
        transactions:
          type: array
          description: transaction collection
          items:
            $ref: '#/components/schemas/TransactionStatusResponseList'
        currentPageNumber:
          type: integer
          description: Page Number of the current request
        currentPageSize:
          type: integer
          description: Number of items fetched
        maximumPageNumber:
          type: integer
          description: maximum page Number to fetch total records with current page size
        totalRecords:
          description: total number of records which are matched to the current search
          type: integer
    Error:
      description: An error
      type: object
      properties:
        message:
          type: string
          minLength: 1
          description: Error message text
        type:
          type: string
          description: Error message type
        code:
          type: string
          description: Error message code
        parameters:
          description: Error message parameters
          $ref: '#/components/schemas/Parameters'
      additionalProperties: false
      required:
      - message
    Errors:
      description: A set of errors
      type: object
      properties:
        errors:
          description: List of errors
          type: array
          items:
            type: object
            $ref: '#/components/schemas/Error'
        total_records:
          description: Total number of errors
          type: integer
      additionalProperties: false
    DcbUpdateTransaction:
      type: object
      properties:
        item:
          $ref: '#/components/schemas/DcbUpdateItem'
    DcbPickup:
      description: Pickup Location metadata required for the pickup service point
      type: object
      properties:
        libraryCode:
          description: The code which identifies the pickup library
          type: string
        servicePointId:
          description: UUID of the pickup service point
          type: string
        servicePointName:
          description: The name of the pickup service point
          type: string
    DcbUpdateItem:
      description: Item metadata required for updating the existing transaction
      type: object
      properties:
        barcode:
          description: The barcode of the item as specified in the lending library
          type: string
        materialType:
          description: The “hub-normalized” form of the item item type, used in the circulation rules for determining the correct loan policy.
          type: string
        lendingLibraryCode:
          description: The code which identifies the lending library
          type: string
      additionalProperties: false
      required:
      - barcode
      - materialType
      - lendingLibraryCode
    uuid:
      $schema: http://json-schema.org/draft-04/schema#
      description: A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/
      type: string
      pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[1-5][a-fA-F0-9]{3}-[89abAB][a-fA-F0-9]{3}-[a-fA-F0-9]{12}$
    TransactionStatusResponseList:
      properties:
        id:
          description: Unique identifier of a transaction
          $ref: '#/components/schemas/uuid'
      allOf:
      - $ref: '#/components/schemas/TransactionStatusResponse'
    DcbTransaction:
      type: object
      properties:
        item:
          $ref: '#/components/schemas/DcbItem'
        patron:
          $ref: '#/components/schemas/DcbPatron'
        pickup:
          $ref: '#/components/schemas/DcbPickup'
        requestId:
          description: ID of the existing circulation TLR
          type: string
        selfBorrowing:
          description: selfBorrowing flag for BORROWING_PICKUP role to allow patrons to request items from own library via DCB
          type: boolean
        role:
          type: string
          enum:
          - LENDER
          - BORROWER
          - PICKUP
          - BORROWING-PICKUP
    DcbItem:
      description: Item metadata required for the transaction
      type: object
      properties:
        id:
          description: The unique item identifier
          $ref: '#/components/schemas/uuid'
        title:
          description: The title of the item that has been requested
          type: string
        barcode:
          description: The barcode of the item as specified in the lending library
          type: string
        materialType:
          description: The “hub-normalized” form of the item item type, used in the circulation rules for determining the correct loan policy.
          type: string
        lendingLibraryCode:
          description: The code which identifies the lending library
          type: string
        locationCode:
          description: The location code of the item, representing the library agency code used for determining loan policy flexibility.
          type: string
        renewalInfo:
          $ref: '#/components/schemas/renewalInfo'
        holdCount:
          description: The number of holds on the item (Will be returned only for Lender role)
          type: integer
    ClaimedReturnedResolution:
      type: string
      description: Claimed returned resolution
      enum:
      - Found by library
      - Returned by patron
    Parameter:
      description: List of key/value parameters of an error
      type: object
      properties:
        key:
          type: string
          minLength: 1
        value:
          type: string
      additionalProperties: false
      required:
      - key
    renewalInfo:
      type: object
      properties:
        renewalCount:
          description: renewalCount of the loan
          type: integer
        renewalMaxCount:
          description: renewalMaxCount of loan as per the loan policy configuration
          type: integer
        renewable:
          description: renewable
          type: boolean
  parameters:
    dcbTransactionId:
      in: path
      name: dcbTransactionId
      schema:
        type: string
      required: true
    pageSize:
      in: query
      name: pageSize
      description: Number of items per page (optional)
      schema:
        type: integer
        default: 1000
        minimum: 1
        maximum: 2147483647
      required: false
    pageNumber:
      in: query
      name: pageNumber
      description: Page number for pagination (optional)
      schema:
        type: integer
        default: 0
        minimum: 0
        maximum: 2147483647
      required: false
    toDate:
      in: query
      name: toDate
      description: End date for filtering transactions
      schema:
        type: string
        format: date-time
      required: true
    fromDate:
      in: query
      name: fromDate
      description: Start date for filtering transactions
      schema:
        type: string
        format: date-time
      required: true
  requestBodies:
    TransactionStatusBody:
      description: TransactionStatus object
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/TransactionStatus'
    DcbUpdateTransaction:
      description: DCB transaction update object
      required: true
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/DcbUpdateTransaction'
    DCBTransaction:
      description: DCB transaction object
      required: true
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/DcbTransaction'
x-refined-from:
- folio-mod-dcb-dcb-transaction-openapi.json
- folio-edge-dcb-openapi.yml
- folio-mod-dcb-dcb-transaction-openapi.yml

FOLIO Transactions API

Operations 8

Documentation

Specifications

SDKs

Schemas & Data

Other Resources