---
updatedAt: 2026-08-18T09:57:06.000Z
agentTools:
  projectIndex: https://docs.moneyhash.io/llms.txt
---

# List plans

List all created plans

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "MoneyHash API",
    "version": "1.1.0",
    "description": "MoneyHash Public APIs documentation"
  },
  "paths": {
    "/api/v1.4/subscriptions/plans/": {
      "get": {
        "operationId": "v1.1_subscriptions_plans_list",
        "description": "List all created plans",
        "summary": "List plans",
        "parameters": [
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "description": "Number of results to return per page.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "offset",
            "required": false,
            "in": "query",
            "description": "The initial index from which to return the results.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "tags": [
          "v1.1"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "AccessTokenAuth": []
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedPlanVersionDetailsList"
                },
                "examples": {
                  "ListAllPlans": {
                    "value": {
                      "count": 123,
                      "next": "http://api.example.org/accounts/?offset=400&limit=100",
                      "previous": "http://api.example.org/accounts/?offset=200&limit=100",
                      "results": [
                        {
                          "status": {
                            "code": 200,
                            "message": "success",
                            "errors": []
                          },
                          "data": {
                            "embed_url": "https://embed.moneyhash.io/embed/card/gxW2jGL/",
                            "id": "gxW2jGL",
                            "hide_header": false,
                            "standalone_tokenization": true
                          },
                          "count": 1,
                          "next": null,
                          "previous": null
                        }
                      ]
                    },
                    "summary": "list all plans",
                    "description": "longer description"
                  }
                }
              }
            },
            "description": ""
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DocsErrorResponse401"
                },
                "examples": {
                  "UnauthorizedAPIKey": {
                    "value": {
                      "status": {
                        "code": 401,
                        "message": "",
                        "errors": [
                          {
                            "detail": "Authentication credentials were not provided."
                          }
                        ]
                      },
                      "data": {},
                      "count": null,
                      "next": null,
                      "previous": null
                    },
                    "summary": "Unauthorized API key",
                    "description": "longer description"
                  }
                }
              }
            },
            "description": ""
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "DocsErrorResponse401": {
        "type": "object",
        "properties": {
          "status": {
            "$ref": "#/components/schemas/DocsStatus"
          },
          "data": {
            "type": "object",
            "additionalProperties": {}
          },
          "count": {
            "type": "integer",
            "nullable": true,
            "description": "Total number of items."
          },
          "next": {
            "type": "string",
            "nullable": true,
            "description": "Next page url if exists"
          },
          "previous": {
            "type": "string",
            "nullable": true,
            "description": "Previous page url if exists"
          }
        },
        "required": [
          "count",
          "data",
          "next",
          "previous",
          "status"
        ]
      },
      "DocsStatus": {
        "type": "object",
        "properties": {
          "data": {
            "description": "Response message"
          }
        },
        "required": [
          "data"
        ]
      },
      "PaginatedPlanVersionDetailsList": {
        "type": "object",
        "properties": {
          "count": {
            "type": "integer",
            "example": 123
          },
          "next": {
            "type": "string",
            "nullable": true,
            "format": "uri",
            "example": "http://api.example.org/accounts/?offset=400&limit=100"
          },
          "previous": {
            "type": "string",
            "nullable": true,
            "format": "uri",
            "example": "http://api.example.org/accounts/?offset=200&limit=100"
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PlanVersionDetails"
            }
          }
        }
      },
      "PlanVersionDetails": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true
          },
          "name": {
            "type": "string",
            "readOnly": true,
            "description": "Plan name."
          },
          "description": {
            "type": "string",
            "readOnly": true,
            "description": "Plan description."
          },
          "currency": {
            "type": "string",
            "readOnly": true,
            "description": "The currency of the plan represented by a string of alphabetic code from ISO 4217 Currency codes."
          },
          "amount": {
            "type": "number",
            "format": "double",
            "readOnly": true,
            "description": "Plan's base amount to be used in subscription invoices."
          },
          "one_time_fee": {
            "type": "string",
            "readOnly": true,
            "description": "One time fee will be added once to the first subscription invoice when subscripting to this plan."
          },
          "trial_period": {
            "type": "integer",
            "readOnly": true,
            "nullable": true,
            "description": "Number of trial days before the first recurring cycle."
          },
          "recurrency": {
            "type": "integer",
            "readOnly": true,
            "description": "The interval at which a subscription is charged."
          },
          "recurrency_unit": {
            "type": "string",
            "readOnly": true,
            "description": "The time unit used to define the recurrency. DAY and MONTH are supported"
          },
          "recurring_cycles": {
            "type": "integer",
            "readOnly": true,
            "nullable": true,
            "description": "The total number of payment cycles in the subscription lifetime. if empty the subscription will be charged forever till canceled."
          },
          "discount_amount": {
            "type": "string",
            "readOnly": true,
            "description": "Discount amount applied."
          },
          "discount_percentage": {
            "type": "string",
            "format": "decimal",
            "pattern": "^-?\\d{0,3}(?:\\.\\d{0,2})?$",
            "readOnly": true,
            "nullable": true,
            "description": "Discount percentage applied."
          },
          "discount_cycles": {
            "type": "integer",
            "readOnly": true,
            "nullable": true,
            "description": "How many cycles the discount will be applied to."
          },
          "is_live": {
            "type": "boolean",
            "readOnly": true
          },
          "created": {
            "type": "string",
            "readOnly": true
          }
        },
        "required": [
          "amount",
          "created",
          "currency",
          "description",
          "discount_amount",
          "discount_cycles",
          "discount_percentage",
          "id",
          "is_live",
          "name",
          "one_time_fee",
          "recurrency",
          "recurrency_unit",
          "recurring_cycles",
          "trial_period"
        ]
      }
    },
    "securitySchemes": {
      "AccessTokenAuth": {
        "type": "apiKey",
        "in": "query",
        "name": "access_token"
      },
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Key"
      }
    }
  },
  "servers": [
    {
      "url": "https://web.moneyhash.io"
    }
  ],
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```