Get Subscription

GET /api/subscription

Retrieves the subscription details for the authenticated user, including plan information, status, billing period, and plan limits.

Authentication

This endpoint requires authentication. Include your access token in the request cookies.

Response

string

required

Current plan name. Options: FREE, BASIC, PRO, ENTERPRISE

string

required

Subscription status. Options: ACTIVE, CANCELLED, EXPIRED, PAST_DUE, UNPAID, TRIALING

number

required

Monthly price of the plan in the currency (e.g., MXN)

string

Start date of the current billing period (ISO 8601 format). Null for FREE plan

string

End date of the current billing period (ISO 8601 format). Null for FREE plan

boolean

required

Whether the subscription will be cancelled at the end of the current period

string

Stripe customer ID. Null for FREE plan

string

Stripe subscription ID. Null for FREE plan

object

required

Plan limits and features

Show Plan Limits

number

Maximum number of RFC profiles allowed. Null means unlimited

number

Maximum XML files per month. Null means unlimited

number

Maximum expenses per month. Null means unlimited

boolean

required

Whether PDF export is enabled

boolean

required

Whether Excel export is enabled

string

required

Level of reports available. Options: basic, complete, advanced

string

required

Type of support available. Options: none, email, priority

boolean

required

Whether API access is enabled

number

SAT basic searches per month. Null means unlimited

number

SAT AI-powered searches per month. Null means unlimited

number

Maximum results per SAT search. Null means no limit

boolean

Whether AI explanations are available for SAT searches

boolean

Whether search history is enabled

boolean

Whether favorites feature is enabled

boolean

Whether alerts feature is enabled

Example Request

curl -X GET "https://api.contafy.com/api/subscription" \
  -H "Cookie: access_token=your_access_token"

Example Response

{
  "plan": "PRO",
  "status": "ACTIVE",
  "planPrice": 599,
  "currentPeriodStart": "2024-03-01T00:00:00Z",
  "currentPeriodEnd": "2024-04-01T00:00:00Z",
  "cancelAtPeriodEnd": false,
  "stripeCustomerId": "cus_123456789",
  "stripeSubscriptionId": "sub_987654321",
  "limits": {
    "profiles": null,
    "invoicesPerMonth": null,
    "expensesPerMonth": null,
    "exportPDF": true,
    "exportExcel": true,
    "reports": "advanced",
    "support": "priority",
    "apiAccess": true,
    "satBasicSearchesPerMonth": null,
    "satAISearchesPerMonth": 500,
    "satMaxResults": null,
    "satHasAIExplanations": true,
    "satHasHistory": true,
    "satHasFavorites": true,
    "satHasAlerts": true
  }
}

Error Responses

error

Authentication required or token expired

{
  "error": "Unauthorized",
  "message": "Authentication required"
}

error

Server error occurred

{
  "error": "Internal Server Error",
  "message": "An unexpected error occurred"
}

Authentication

Profiles

Invoices

Expenses

Subscription

SAT Search

Get Subscription

GET /api/subscription

Authentication

Response

Example Request

Example Response

Error Responses

​GET /api/subscription

​Authentication

​Response

​Example Request

​Example Response

​Error Responses

GET /api/subscription

Authentication

Response

Example Request

Example Response

Error Responses