curl --request POST \
  --url https://{tenantDomain}.conductor.one/api/v1/funds/subject-app-limits/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "appIds": [
    "<string>"
  ],
  "pageSize": 123,
  "pageToken": "<string>",
  "states": {
    "explicitLimit": true,
    "inheriting": true,
    "suspended": true
  },
  "userIds": [
    "<string>"
  ]
}
'

import requests

url = "https://{tenantDomain}.conductor.one/api/v1/funds/subject-app-limits/search"

payload = {
    "appIds": ["<string>"],
    "pageSize": 123,
    "pageToken": "<string>",
    "states": {
        "explicitLimit": True,
        "inheriting": True,
        "suspended": True
    },
    "userIds": ["<string>"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    appIds: ['<string>'],
    pageSize: 123,
    pageToken: '<string>',
    states: {explicitLimit: true, inheriting: true, suspended: true},
    userIds: ['<string>']
  })
};

fetch('https://{tenantDomain}.conductor.one/api/v1/funds/subject-app-limits/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenantDomain}.conductor.one/api/v1/funds/subject-app-limits/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'appIds' => [
        '<string>'
    ],
    'pageSize' => 123,
    'pageToken' => '<string>',
    'states' => [
        'explicitLimit' => true,
        'inheriting' => true,
        'suspended' => true
    ],
    'userIds' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenantDomain}.conductor.one/api/v1/funds/subject-app-limits/search"

	payload := strings.NewReader("{\n  \"appIds\": [\n    \"<string>\"\n  ],\n  \"pageSize\": 123,\n  \"pageToken\": \"<string>\",\n  \"states\": {\n    \"explicitLimit\": true,\n    \"inheriting\": true,\n    \"suspended\": true\n  },\n  \"userIds\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{tenantDomain}.conductor.one/api/v1/funds/subject-app-limits/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"appIds\": [\n    \"<string>\"\n  ],\n  \"pageSize\": 123,\n  \"pageToken\": \"<string>\",\n  \"states\": {\n    \"explicitLimit\": true,\n    \"inheriting\": true,\n    \"suspended\": true\n  },\n  \"userIds\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenantDomain}.conductor.one/api/v1/funds/subject-app-limits/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"appIds\": [\n    \"<string>\"\n  ],\n  \"pageSize\": 123,\n  \"pageToken\": \"<string>\",\n  \"states\": {\n    \"explicitLimit\": true,\n    \"inheriting\": true,\n    \"suspended\": true\n  },\n  \"userIds\": [\n    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "list": [
    {
      "appId": "<string>",
      "controls": {
        "extension": {
          "expiresAt": "2023-11-07T05:31:56Z",
          "limit": {
            "amount": {
              "money": {
                "currencyCode": "<string>",
                "nanos": 123,
                "units": "<string>"
              }
            },
            "blocked": {},
            "unlimited": {}
          },
          "reason": "<string>"
        },
        "limit": {
          "amount": {
            "money": {
              "currencyCode": "<string>",
              "nanos": 123,
              "units": "<string>"
            }
          },
          "blocked": {},
          "unlimited": {}
        },
        "period": "PERIOD_KIND_UNSPECIFIED",
        "suspension": {
          "reason": "<string>",
          "suspendedAt": "2023-11-07T05:31:56Z"
        }
      },
      "createdAt": "2023-11-07T05:31:56Z",
      "deletedAt": "2023-11-07T05:31:56Z",
      "tenantId": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z",
      "userId": "<string>"
    }
  ],
  "nextPageToken": "<string>"
}

Subject App Limits

Search

Search the tenant’s subject-app limit rows. Reads the Postgres mirror: the runtime row is keyed on (tenant, subject), so a tenant-wide listing has no runtime query at all. Filters narrow by subject, by app, and by state; empty filters return every live row in the tenant.

POST rather than GET: the filters are repeated fields, which the gateway cannot carry as query parameters. Pagination is keyset-based over (pksk), the storage primary key, so a concurrent write to a filtered field cannot duplicate or omit a row across pages the way an offset page can.

POST

api

funds

subject-app-limits

curl --request POST \
  --url https://{tenantDomain}.conductor.one/api/v1/funds/subject-app-limits/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "appIds": [
    "<string>"
  ],
  "pageSize": 123,
  "pageToken": "<string>",
  "states": {
    "explicitLimit": true,
    "inheriting": true,
    "suspended": true
  },
  "userIds": [
    "<string>"
  ]
}
'

import requests

url = "https://{tenantDomain}.conductor.one/api/v1/funds/subject-app-limits/search"

payload = {
    "appIds": ["<string>"],
    "pageSize": 123,
    "pageToken": "<string>",
    "states": {
        "explicitLimit": True,
        "inheriting": True,
        "suspended": True
    },
    "userIds": ["<string>"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    appIds: ['<string>'],
    pageSize: 123,
    pageToken: '<string>',
    states: {explicitLimit: true, inheriting: true, suspended: true},
    userIds: ['<string>']
  })
};

fetch('https://{tenantDomain}.conductor.one/api/v1/funds/subject-app-limits/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenantDomain}.conductor.one/api/v1/funds/subject-app-limits/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'appIds' => [
        '<string>'
    ],
    'pageSize' => 123,
    'pageToken' => '<string>',
    'states' => [
        'explicitLimit' => true,
        'inheriting' => true,
        'suspended' => true
    ],
    'userIds' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenantDomain}.conductor.one/api/v1/funds/subject-app-limits/search"

	payload := strings.NewReader("{\n  \"appIds\": [\n    \"<string>\"\n  ],\n  \"pageSize\": 123,\n  \"pageToken\": \"<string>\",\n  \"states\": {\n    \"explicitLimit\": true,\n    \"inheriting\": true,\n    \"suspended\": true\n  },\n  \"userIds\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{tenantDomain}.conductor.one/api/v1/funds/subject-app-limits/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"appIds\": [\n    \"<string>\"\n  ],\n  \"pageSize\": 123,\n  \"pageToken\": \"<string>\",\n  \"states\": {\n    \"explicitLimit\": true,\n    \"inheriting\": true,\n    \"suspended\": true\n  },\n  \"userIds\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenantDomain}.conductor.one/api/v1/funds/subject-app-limits/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"appIds\": [\n    \"<string>\"\n  ],\n  \"pageSize\": 123,\n  \"pageToken\": \"<string>\",\n  \"states\": {\n    \"explicitLimit\": true,\n    \"inheriting\": true,\n    \"suspended\": true\n  },\n  \"userIds\": [\n    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "list": [
    {
      "appId": "<string>",
      "controls": {
        "extension": {
          "expiresAt": "2023-11-07T05:31:56Z",
          "limit": {
            "amount": {
              "money": {
                "currencyCode": "<string>",
                "nanos": 123,
                "units": "<string>"
              }
            },
            "blocked": {},
            "unlimited": {}
          },
          "reason": "<string>"
        },
        "limit": {
          "amount": {
            "money": {
              "currencyCode": "<string>",
              "nanos": 123,
              "units": "<string>"
            }
          },
          "blocked": {},
          "unlimited": {}
        },
        "period": "PERIOD_KIND_UNSPECIFIED",
        "suspension": {
          "reason": "<string>",
          "suspendedAt": "2023-11-07T05:31:56Z"
        }
      },
      "createdAt": "2023-11-07T05:31:56Z",
      "deletedAt": "2023-11-07T05:31:56Z",
      "tenantId": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z",
      "userId": "<string>"
    }
  ],
  "nextPageToken": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Authorization

string

header

required

This API uses OAuth2 with the Client Credential flow. Client Credentials must be sent in the BODY, not the headers. For an example of how to implement this, refer to the c1TokenSource.Token() function.

Body

application/json

The SubjectAppLimitServiceSearchRequest message.

appIds

string[] | null

Restrict to these apps; empty returns every app.

pageSize

integer<int32>

The pageSize field.

pageToken

string

The pageToken field.

states

Subject App Limit State Filter · object | null

SubjectAppLimitStateFilter is the structured state filter. The three states are mutually exclusive by construction: suspended is suspension present; explicit-limit is suspension absent AND limit present; inheriting is neither. Combining them is a union. Unset (all false) does not filter by state at all.

Show child attributes

userIds

string[] | null

Restrict to these subjects; empty returns every row in the tenant.

Response

200 - application/json

Successful response

The SubjectAppLimitServiceSearchResponse message.

list

Subject App Limit · object[] | null

The list field.

Show child attributes

nextPageToken

string

The nextPageToken field.

Welcome

Endpoints

Search

Authorizations

Body

Response