How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Paid plans API

The plans API from Paid — 12 operation(s) for plans.

Paid plans API is one of 22 APIs that Paid publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Plans. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 15 operations across 12 paths, and defines 118 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://api.agentpaid.io/api/v1.

15 operations 12 paths 118 schemas 8 GET4 POST3 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.agentpaid.io/api/v2
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Paid plans API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth).

Paths & Operations 15

Across 12 paths, the API surfaces 15 operations — 8 GET, 4 POST, 3 PUT. Each is listed below with its method, path, parameters, and response codes.

plans 15
GET
/plans/current
Get customer's current plan
get-current 2 params → 200400403404
GET
/plans/{planId}
Get plan by ID
get-by-id 2 params → 200403404
GET
/plans/{planId}/usage
Fetch usage summaries for a plan and customer
get-usage 7 params → 200400403404
POST
/plans/{planId}/subscribe
Subscribe customer to plan
subscribe 4 params → 200400403404
POST
/plans/{planId}/unsubscribe
Unsubscribe customer from plan
unsubscribe 3 params → 200400403404
POST
/plans/upgrade
Upgrade customer to a new plan
upgrade 4 params → 200400403404
GET
/plans/planGroup/{planGroupId}
Get plan group by ID
get-group-by-id 2 params → 200403404
GET
/plans/planGroup/{planGroupId}/plans
Get plans for a plan group
get-group-plans 2 params → 200403404
GET
/plans/
List plans
list-plans 6 params → 200400403404500
POST
/plans/
Create a new plan
create-plan 1 param body → 201400403404500
PUT
/plans/upgrade-path
Update plan upgrade path
update-plan-upgrade-path 1 param body → 200400403404500
GET
/plans/{id}
Get plan
get-plan-by-id 2 params → 200403404500
PUT
/plans/{id}
Update plan
update-plan-by-id 2 params body → 200400403404500
GET
/plans/external/{externalId}
Get plan by external ID
get-plan-by-external-id 2 params → 200403404500
PUT
/plans/external/{externalId}
Update plan by external ID
update-plan-by-external-id 2 params body → 200400403404500

Schemas 118

The contract defines 118 schemas that model the data the API accepts and returns. The most detailed are UsageSummary (17 properties), Order (16 properties), OrderLine (14 properties), Product (13 properties). Each schema is shown below with its type and property counts.

ProductPricingInputDiscriminatorMappingSeatBasedGraduatedBillingType
string
ProductPricingInputDiscriminatorMappingUsageVolumeSignalType
string
ProductPricingInputDiscriminatorMappingSeatBasedVolumeBillingFrequency
string
PricingModelType
string
Agent
object
8 properties 4 required
Customer
object
13 properties 3 required
ProductPricingInputDiscriminatorMappingUsageBracketedPrepaidCreditsBillingFrequency
string
ProductPricingInputDiscriminatorMappingUsageVolumeBillingType
string
UsageSummaryOrder
object
Associated order information
2 properties
PlanWithFeatures
object
A plan with its features (product-attribute pairs) for display
10 properties 7 required
ProductPricingInputDiscriminatorMappingUsageCostPlusBillingType
string
plans_getCurrent_Response_200
object
2 properties 2 required
ProductPricingInputDiscriminatorMappingUsagePerUnitSignalType
string
Plan_2
object
12 properties 12 required
PlanCreditBenefitRecipient
string
ProductType
string
The type of product
PlanListResponse
object
2 properties 2 required
OrderLineAttributePricing
object
5 properties
ProductPricingInput
PlanPricing
object
The pricing configuration for a plan. Uses the same PricePoints structure as product pricing.
3 properties 2 required
Pagination
object
4 properties 4 required
PlansCurrentGetResponsesContentApplicationJsonSchemaPlanFeaturesItems
object
4 properties 4 required
ProductPricingInputDiscriminatorMappingRecurringVolumeBillingType
string
ProductPricingInputDiscriminatorMappingUsagePrepaidCreditsSignalType
string
ProductCreditBenefitInput
object
10 properties 2 required
CancelRenewalResponse
object
Response after successfully cancelling an order's renewal
5 properties 5 required
ErrorResponse
object
3 properties 1 required
Tier
object
3 properties
ProrationDetail
object
Details about the proration calculation for an attribute
8 properties
PlanCreditBenefit
object
10 properties 2 required
PlanWithFeaturesType
string
The type of plan (flat for fixed pricing, usage for usage-based, credit for prepaid credits)
ProductPricingInputDiscriminatorMappingUsagePerUnitBillingType
string
Order
object
16 properties
PlansCurrentGetResponsesContentApplicationJsonSchemaPlan
object
The plan details, or null if the customer has no active plan
9 properties 6 required
PlanGroup
object
A plan group containing multiple plans
7 properties 5 required
ProductPricingInputDiscriminatorMappingUsageBracketedPrepaidCreditsCreditUnitBracketsItems
object
2 properties 2 required
AgentPricePoint
object
4 properties
PlanPricing_2
object
Pricing configuration for a plan attribute. Money amounts are expressed in cents.
4 properties 4 required
ProductPricingInputDiscriminatorMappingUsageGraduatedSignalType
string
UsageSummary
object
A single usage summary record
17 properties 13 required
ProductSimplePricePointTiersItemsTierBillingType
string
PlanAttributeInput
object
3 properties 2 required
ChargeType
string
ProductPricingInputDiscriminatorMappingRecurringGraduatedBillingType
string
PlansCurrentGetResponsesContentApplicationJsonSchemaSubscription
object
The subscription details, or null if the customer has no active plan
5 properties 4 required
ProductPricingInputDiscriminatorMappingSeatBasedPerUnitBillingType
string
ProductTieredPricePointTiersItems
object
7 properties 1 required
PlanPlanProductsItems
object
8 properties
ProductPricingInputDiscriminatorMappingUsageGraduatedBillingType
string
ProductPricingInputDiscriminatorMappingUsagePerUnitBillingFrequency
string
PlanStatus
string
ProductPricingInputDiscriminatorMappingUsageVolumeBillingFrequency
string
ProductPricingInputDiscriminatorMappingSeatBasedVolumeBillingType
string
ProductPricingInputDiscriminatorMappingRecurringPerUnitBillingFrequency
string
Error
object
An error response from the Paid API
1 property 1 required
PlanCreditBenefitCreditGrantTiming
string
ProductTieredPricePoint
object
6 properties 3 required
ProductPricingInputDiscriminatorMappingRecurringGraduatedBillingFrequency
string
ProductPricingInputDiscriminatorMappingUsagePrepaidCreditsBillingFrequency
string
PlanAttribute
object
5 properties 5 required
ProductCreditBenefitInputAllocationCadence
string
ProductPricingInputDiscriminatorMappingSeatBasedPerUnitBillingFrequency
string
ProductSimplePricePointTiersItems
object
7 properties 1 required
CreationState
string
AgentAttribute
object
3 properties 3 required
ApiError
object
An API error response from the Paid API
3 properties
ProductPricingInputDiscriminatorMappingUsageGraduatedBillingFrequency
string
PlanUpgradePathGroup
object
2 properties 2 required
ProductPricingInputDiscriminatorMappingOneTimePerUnitFeeType
string
ProductTieredPricePointTiersItemsTierBillingType
string
PlanPricingPricingType
string
ProductPricingInputDiscriminatorMappingRecurringPercentOfTotalBillingFrequency
string
CreatePlanRequest
object
6 properties 2 required
UpdatePlanUpgradePathRequest
object
2 properties 2 required
ProductPricingInputDiscriminatorMappingOneTimePerUnitBillingType
string
ProductPricingInputDiscriminatorMappingUsagePrepaidCreditsBillingType
string
ProductPricingInputDiscriminatorMappingRecurringPerUnitBillingType
string
ProductPricingInputDiscriminatorMappingSeatBasedPrepaidCreditsBillingFrequency
string
ProrationUpgradeResponse
object
Response after successfully scheduling a plan change
8 properties 8 required
ProductPricingInputDiscriminatorMappingUsageCostPlusSignalType
string
PricePoint
object
4 properties
UpdatePlanRequest
object
6 properties
PlanUpgradePathResponse
object
1 property 1 required
PlansCurrentGetResponsesContentApplicationJsonSchemaPlanType
string
The type of plan
OrderLineAttribute
object
4 properties
ProductPricingInputDiscriminatorMappingUsageBracketedPrepaidCreditsPricingInput
object
1 property 1 required
ProductPricingInputDiscriminatorMappingSeatBasedGraduatedBillingFrequency
string
ProductSimplePricePoint
object
6 properties 2 required
UsageSummariesResponse
object
Response containing usage summaries and pagination metadata
2 properties 2 required
CustomerMetadata
object
Flexible JSON field for storing custom metadata about the customer
PlanType
string
The type of plan (flat for fixed pricing, usage for usage-based, credit for prepaid credits)
ProductCreditBenefitInputCreditGrantTiming
string
UpdatePlanRequestStatus
string
Set to archived to archive this plan, or active to restore it.
Address
object
6 properties 5 required
Pricing
object
7 properties 5 required
UsageSummaryOrderLine
object
Associated order line information
2 properties
BillingFrequency
string
ProductPricingInputDiscriminatorMappingUsageCostPlusBillingFrequency
string
PlanPricingBillingFrequency
string
The billing frequency for the plan
ProductPricingInputDiscriminatorMappingUsageBracketedPrepaidCreditsSignalType
string
OrderLine
object
14 properties
Plan
object
A plan containing products and their attributes
12 properties 8 required
PlanPlanProductsItemsPlanProductAttributeItems
object
7 properties
PlanCreditBenefitAllocationCadence
string
ProductPricingInputDiscriminatorMappingSeatBasedPrepaidCreditsBillingType
string
Product
object
A product in the Paid system (previously called Agent)
13 properties 5 required
UsagePaginationMeta
object
Pagination metadata for usage summaries
4 properties 4 required
TaxExemptStatus
string
CreationSource
string
PlansCurrentGetResponsesContentApplicationJsonSchemaPlanFeaturesItemsUsage
object
Current usage and limits for this feature
4 properties 4 required
PlanWithFeaturesFeaturesItems
object
3 properties 3 required
ProductCreditBenefitInputRecipient
string
ProductPricingInputDiscriminatorMappingRecurringVolumeBillingFrequency
string
PlanCreditBenefitRolloverDurationUnit
string
ProductPricingInputDiscriminatorMappingUsageBracketedPrepaidCreditsBillingType
string
AgentPricePointTiers
object
3 properties 1 required
ProductPricingInputDiscriminatorMappingRecurringPercentOfTotalBillingType
string
ProductPricingInputDiscriminatorMappingUsageBracketedPrepaidCreditsPricingInputKind
string

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

paid-plans-api-openapi.yml Raw ↑

Other APIs Paid publishes across the network.

Paid agents API
Paid analyticsExperimental API
Paid checkouts API
Paid contacts API
Paid costs API
Paid credits API
Paid customer-groups API
Paid customer-portals API
Paid customers API
Paid customViewsExperimental API
Paid invoices API
Paid orders API
Where this information came from

This is an independent, third-party profile of Paid plans API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.