AlayaCare take rates API
The take rates API from AlayaCare — 3 operation(s) for take rates.
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/alayacare-take-rates-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: Alayacare take rates API
version: '1.0'
servers:
- url: https://api.{env}.alayamarket.{region}/offers
variables:
env:
description: The server environment.
enum:
- staging
- sandbox
- prod
default: prod
region:
description: The server top-level domain indicating the region.
enum:
- ca
- com
- com.au
default: ca
security:
- CognitoAuthorizer: []
tags:
- name: take rates
paths:
/v1/sys_admin/take_rates/demand_take_rates:
get:
tags:
- take rates
description: '# Authorization
Required role: `sys_admin`
# Description
Get a collection of take rates specific to demand organizations.
'
parameters:
- in: query
name: demand_persona_id
schema:
type: string
format: uuid
responses:
200:
description: Successfully returned demand take rates collection
content:
application/json:
schema:
$ref: '#/components/schemas/DemandTakeRateCollectionResponse'
x-amazon-apigateway-integration:
uri:
Fn::Sub: arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/${OfferApiFunctionV2.Arn}:live/invocations
httpMethod: POST
passthroughBehavior: when_no_match
type: aws_proxy
/v1/sys_admin/take_rates/demand_take_rates/{demand_persona_id}:
parameters:
- in: path
name: demand_persona_id
schema:
type: string
format: uuid
required: true
description: ID of an organization.
post:
tags:
- take rates
description: '# Authorization
Required role: `sys_admin`
# Description
Set the take rate specific to a demand organization.
Note: a null take rate means the system will clear the demand-specific take rate
and apply the next available take rate (e.g., the regional take rate).
A take rate of 0 is a take rate of 0%.
'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DemandTakeRateCreateRequest'
responses:
204:
description: Successfully set the demand-specific take rate.
x-amazon-apigateway-integration:
uri:
Fn::Sub: arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/${OfferApiFunctionV2.Arn}:live/invocations
httpMethod: POST
passthroughBehavior: when_no_match
type: aws_proxy
/v1/sys_admin/take_rates/regional_take_rate:
get:
tags:
- take rates
description: '# Authorization
Required role: `sys_admin`
# Description
Get a regional take rate.
'
responses:
200:
description: Successfully returned regional take rate
content:
application/json:
schema:
$ref: '#/components/schemas/RegionalTakeRateDetailResponse'
x-amazon-apigateway-integration:
uri:
Fn::Sub: arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/${OfferApiFunctionV2.Arn}:live/invocations
httpMethod: POST
passthroughBehavior: when_no_match
type: aws_proxy
post:
tags:
- take rates
description: '# Authorization
Required role: `sys_admin`
# Description
Set the regional take rate.
'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/RegionalTakeRateUpdateRequest'
responses:
200:
description: Successfully returned regional take rate
content:
application/json:
schema:
$ref: '#/components/schemas/RegionalTakeRateDetailResponse'
x-amazon-apigateway-integration:
uri:
Fn::Sub: arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/${OfferApiFunctionV2.Arn}:live/invocations
httpMethod: POST
passthroughBehavior: when_no_match
type: aws_proxy
components:
schemas:
DemandTakeRateCreateRequest:
type: object
properties:
rate:
$ref: '#/components/schemas/TakeRateCore'
TakeRateCore:
type: number
format: decimal
minimum: 0
maximum: 1
description: 'A percentage of the offer price set by demand, represented by a fraction
between 0 and 1. For example, a regional take rate of 0.1 is 10%.
'
DemandTakeRateCore:
type: object
properties:
demand_persona_id:
type: string
format: uuid
rate:
$ref: '#/components/schemas/TakeRateCore'
required:
- demand_persona_id
- rate
DemandTakeRateCollectionResponse:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/DemandTakeRateCore'
RegionalTakeRateDetailResponse:
type: object
properties:
rate:
$ref: '#/components/schemas/TakeRateCore'
required:
- rate
RegionalTakeRateUpdateRequest:
type: object
properties:
rate:
$ref: '#/components/schemas/TakeRateCore'
required:
- rate
securitySchemes:
CognitoAuthorizer:
type: apiKey
name: Authorization
in: header
x-amazon-apigateway-authtype: cognito_user_pools
x-amazon-apigateway-authorizer:
type: cognito_user_pools
providerARNs:
- Fn::Sub: '{{resolve:ssm:/${StackName}/${UserPoolArnSSMParameterName}}}'
x-amazon-apigateway-request-validators:
body:
validateRequestBody: true
validateRequestParameters: false
params:
validateRequestBody: false
validateRequestParameters: true
params-and-body:
validateRequestBody: true
validateRequestParameters: true
x-amazon-apigateway-request-validator: params
x-amazon-apigateway-gateway-responses:
BAD_REQUEST_BODY:
statusCode: 400
responseTemplates:
application/json: '{"message": $context.error.messageString, "description": "$context.error.validationErrorString"}'