FIS Global Order Controller V2 API
The OrderControllerV2 API from FIS Global — 1 operation(s) for ordercontrollerv2.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/fis-ordercontrollerv2-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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: FIS® Accounting Data as a Service™ Order Controller V2 API
description: What's changed in our API
version: v2
contact: {}
servers:
- url: https://api.railz.ai
description: Main (production) API server
tags:
- name: OrderControllerV2
paths:
/v2/commerce/orders:
get:
description: '**Supported for:**
`shopify` `square`'
operationId: order
parameters:
- name: connectionUuid
required: true
in: query
description: Unique connection identifier.
schema:
example: CON-396d5daa-26b2-4979-89b6-cafb2c298155
type: string
- name: offset
required: false
in: query
description: The offset is the position in the dataset of a particular record.
schema:
format: integer
type: number
- name: limit
required: false
in: query
description: 'This is the size of the results set you would like (default: 100).'
schema:
format: integer
example: 100
type: number
- name: orderBy
required: false
in: query
schema:
type: string
- name: id
required: false
in: query
schema:
example: '12345'
type: string
- name: fulfillmentStatus
required: false
in: query
schema:
example: fulfilled
type: string
enum:
- fulfilled
- partial
- unfulfilled
- cancelled
- unknown
- name: paymentStatus
required: false
in: query
schema:
example: approved
type: string
enum:
- pending
- approved
- paid
- failed
- cancelled
- refunded
- unknown
- name: status
required: false
in: query
schema:
example: cancelled
type: string
enum:
- open
- closed
- cancelled
- unknown
- draft
- name: startDate
required: false
in: query
schema:
example: '2014-04-25'
type: string
- name: endDate
required: false
in: query
schema:
example: '2014-04-25'
type: string
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/GetOrderResponseV2Dto'
'202':
description: Data in pending state
content:
application/json:
schema:
$ref: '#/components/schemas/GetOrderResponseV2Dto'
'204':
description: No data available
'400':
description: Bad Request Error - Thrown if fields sent via query does not follow specifications
content:
application/json:
schema:
$ref: '#/components/schemas/Error400ResponseDtoV2'
'401':
description: Unauthorized - Not logged in or log in expired
content:
application/json:
schema:
$ref: '#/components/schemas/Error401ResponseDto'
'403':
description: Forbidden - Not enough permission
content:
application/json:
schema:
$ref: '#/components/schemas/Error403ResponseDto'
'500':
description: Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error500ResponseDto'
security:
- bearer: []
summary: List Orders
tags:
- OrderControllerV2
components:
schemas:
Error403ResponseDto:
type: object
properties:
error:
readOnly: true
allOf:
- $ref: '#/components/schemas/Error403Dto'
payload:
type: object
readOnly: true
example: {}
required:
- error
- payload
Error401Dto:
type: object
properties:
statusCode:
type: number
readOnly: true
example: 401
message:
readOnly: true
example:
- Unauthorized
type: array
items:
type: string
error:
type: string
readOnly: true
example: Unauthorized
required:
- statusCode
- message
- error
Error401ResponseDto:
type: object
properties:
error:
readOnly: true
allOf:
- $ref: '#/components/schemas/Error401Dto'
payload:
type: object
readOnly: true
example: {}
required:
- error
- payload
Lines:
type: object
properties:
id:
type: string
example: '466157049'
balances:
type: array
items:
$ref: '#/components/schemas/Balance'
accountRef:
$ref: '#/components/schemas/AccountRef'
customerRef:
$ref: '#/components/schemas/AccountRef'
trackingCategoryRefs:
type: array
items:
$ref: '#/components/schemas/TrackingCategoryResponse'
GetOrderResponseV2Dto:
type: object
properties:
pagination:
$ref: '#/components/schemas/PaginationMetaData'
data:
type: array
items:
$ref: '#/components/schemas/GetOrderData'
count:
type: number
readOnly: true
example: 1
format: integer
deprecated: true
meta:
$ref: '#/components/schemas/BasicStartEndDateReportMetaDataV2'
required:
- pagination
- data
- count
- meta
PaginationMetaData:
type: object
properties:
offset:
type: number
readOnly: true
limit:
type: number
readOnly: true
count:
type: number
readOnly: true
required:
- offset
- limit
- count
Error500Dto:
type: object
properties:
error:
type: string
readOnly: true
example: Internal Server Error
message:
readOnly: true
example:
- INTERNAL_ERROR
type: array
items:
type: string
statusCode:
type: number
readOnly: true
example: 500
required:
- error
- message
- statusCode
AccountRef:
type: object
properties:
id:
type: string
example: '145'
name:
type: string
example: Example account
required:
- id
FulfillmentRefs:
type: object
properties:
carrier:
type: string
example: USPS
trackingNumber:
type: string
example: 1Z2345
service:
type: string
example: manual
trackingUrl:
type: string
example: https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z2345
Error400DtoV2:
type: object
properties:
statusCode:
type: number
readOnly: true
example: 400
message:
readOnly: true
example:
- connectionUuid should not be empty
type: array
items:
type: string
error:
type: string
readOnly: true
example: Bad Request
required:
- statusCode
- message
- error
BasicStartEndDateReportMetaDataV2:
type: object
properties:
connectionUuid:
type: string
readOnly: true
example: CON-396d5daa-26b2-4979-89b6-cafb2c298155
businessName:
type: string
readOnly: true
example: Railz
serviceName:
type: string
readOnly: true
example: xero
enum:
- freshbooks
- quickbooks
- quickbooksDesktop
- xero
- oracleNetsuite
- sageBusinessCloud
- sageIntacct
- dynamicsBusinessCentral
- dynamics365Finance
- wave
- myob
- zohoBooks
- byod
reportId:
readOnly: true
example:
- 5fad8a342a88364234392fb5
type: array
items:
type: string
createdAt:
type: string
readOnly: true
example: '2020-11-25T01:02:03Z'
format: date-time
updatedAt:
type: string
example: '2020-11-30T01:02:03Z'
format: date-time
readOnly: false
startDate:
type: string
readOnly: true
example: '2020-11-25T01:02:03Z'
format: date-time
endDate:
type: string
readOnly: true
example: '2020-11-30T01:02:03Z'
format: date-time
required:
- connectionUuid
- businessName
- serviceName
- reportId
- createdAt
- updatedAt
- startDate
- endDate
OrderCustomerRef:
type: object
properties:
id:
type: string
example: '207119551'
customerName:
type: string
example: Amelia Earhart
email:
type: string
example: Amelia.Earhart@example.com
required:
- id
Balance:
type: object
properties:
amount:
type: string
example: 2.2
format: float
date:
format: date-time
type: string
example: '2022-03-11T11:29:03-05:00'
CommerceCurrencyRef:
type: object
properties:
id:
type: string
symbol:
type: string
example: CAD
name:
type: string
example: Canadian Dollar
required:
- symbol
- name
OrderTransactionSourceRefs:
type: object
properties:
id:
type: string
example: '699519475'
type:
type: string
example: payment
enum:
- failedPayout
- payment
- paymentFee
- paymentFeeRefund
- payout
- refund
- transfer
- dispute
- order
- other
- unknown
totalAmount:
type: number
example: '50.00'
format: float
required:
- id
- totalAmount
RefundRefs:
type: object
properties:
id:
type: string
example: 2
totalAmount:
type: number
example: 2
format: float
required:
- id
- totalAmount
BillingAddress:
type: object
properties:
line1:
type: string
example: 1234 Park Street
line2:
type: string
example: Suite 1000
city:
type: string
example: Toronto
region:
type: string
example: 'ON'
country:
type: string
example: CAN
postalCode:
type: string
example: A0B1C2
Error400ResponseDtoV2:
type: object
properties:
error:
readOnly: true
allOf:
- $ref: '#/components/schemas/Error400DtoV2'
payload:
type: object
readOnly: true
required:
- error
- payload
ShippingAddress:
type: object
properties:
line1:
type: string
example: 1234 Park Street
line2:
type: string
example: Suite 1000
city:
type: string
example: Toronto
region:
type: string
example: 'ON'
country:
type: string
example: CAN
postalCode:
type: string
example: A0B1C2
TrackingCategoryResponse:
type: object
properties:
id:
type: string
example: '4040'
readOnly: false
name:
type: string
readOnly: false
example: Region
type:
type: string
example: class
enum:
- class
- department
- location
- unknown
Error403Dto:
type: object
properties:
statusCode:
type: number
readOnly: true
example: 403
message:
readOnly: true
example:
- Forbidden resource
type: array
items:
type: string
error:
type: string
readOnly: true
example: Forbidden
required:
- statusCode
- message
- error
GetOrderData:
type: object
properties:
id:
type: string
example: '450789469'
orderNumber:
type: string
example: '1001'
fulfillmentRefs:
type: array
items:
$ref: '#/components/schemas/FulfillmentRefs'
lines:
type: array
items:
$ref: '#/components/schemas/Lines'
refundRefs:
type: array
items:
$ref: '#/components/schemas/RefundRefs'
transactionSourceRefs:
type: array
items:
$ref: '#/components/schemas/OrderTransactionSourceRefs'
shippingAddress:
$ref: '#/components/schemas/ShippingAddress'
billingAddress:
$ref: '#/components/schemas/BillingAddress'
customerRef:
$ref: '#/components/schemas/OrderCustomerRef'
currencyRef:
$ref: '#/components/schemas/CommerceCurrencyRef'
totalShippingAmount:
type: number
example: 30
format: float
totalGratuityAmount:
type: number
example: 4.87
format: float
totalDiscountAmount:
type: number
example: 0
format: float
totalTaxAmount:
type: number
example: 11.94
format: float
totalAmount:
type: number
example: 598.94
format: float
createdDate:
format: date-time
type: string
example: '2022-03-11T11:29:03-05:00'
sourceModifiedDate:
format: date-time
type: string
example: '2022-03-11T11:29:03-05:00'
status:
type: string
enum:
- open
- closed
- cancelled
- unknown
- draft
paymentStatus:
type: string
enum:
- pending
- approved
- paid
- failed
- cancelled
- refunded
- unknown
fulfillmentStatus:
type: string
enum:
- fulfilled
- partial
- unfulfilled
- cancelled
- unknown
required:
- id
- totalTaxAmount
- totalAmount
- createdDate
- sourceModifiedDate
- status
- paymentStatus
- fulfillmentStatus
Error500ResponseDto:
type: object
properties:
error:
readOnly: true
allOf:
- $ref: '#/components/schemas/Error500Dto'
payload:
type: object
readOnly: true
required:
- error
- payload
securitySchemes:
bearer:
scheme: bearer
bearerFormat: JWT
type: http