Sign in

v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Program flex controls

List program flex controls

List all flex controls grouped by program, with pagination support. Results are ordered by program ID in ascending order.

Use the optional programId query parameter to filter results to a single program. If programId is provided and no templates are found for that program, a 404 is returned.

If no programId is specified and no templates exist at all, an empty paginated response is returned with status 200.

get/v1/flex-controls

Query parameters

programIdinteger
Example:123

Filter flex controls by a specific program ID. Must be a positive integer greater than 0.

pageinteger
Example:1

Page number for pagination. Must be greater than or equal to 1. Defaults to 1 when omitted.

perPageinteger
Example:10

Number of programs to return per page. Must be greater than or equal to 1. Defaults to 10 when omitted.

Headers

x-tenantstring required
Example:org-12345

Organization ID / tenant identifier.

Response

OK. Returns paginated flex controls grouped by program.

pagesinteger required

Total number of pages

current_pageinteger required

Current page number

per_pageinteger required

Number of programs per page

total_itemsinteger required

Total number of programs

Example response

{
  "pages": 5,
  "current_page": 1,
  "per_page": 10,
  "total_items": 45,
  "programs": [
    {
      "program_id": 1234,
      "controls": {
        "restriction_controls": [
          {
            "name": "Single POS value card level limit",
            "type": "restriction",
            "level": "card",
            "processing_codes": {
              "credit": "219803",
              "debit": "219803"
            },
            "conditions": [
              {
                "type": "MERCHANT_NAME_LIST",
                "operator": "eq",
                "data": "10"
              }
            ],
            "deny_code": "Single_POS_Value",
            "active": true
          }
        ],
        "accumulator_controls": [
          {
            "name": "Cumulative POS value card level limit",
            "type": "spending_limit",
            "level": "account",
            "processing_codes": {
              "credit": "219803",
              "debit": "219803"
            },
            "max_limit": 1000,
            "max_amount": 100000,
            "max_transactions": 10,
            "limit_duration": "P1M",
            "conditions": [
              {
                "type": "MERCHANT_NAME_LIST",
                "operator": "eq",
                "data": "10"
              }
            ],
            "deny_code": "CUM_POS_Value",
            "active": true
          }
        ]
      }
    }
  ]
}