# Request all Subscriptions

`GET /api/subscriptions/`



- **Group:** Subscriptions
- **Since:** v0.0.0
- **Authentication:** `authtoken` header, created under Setup > API > API Management
- **HTML version:** /apiguide/subscriptions/request-subscriptions/

## Headers

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `authtoken` | String | **required** | Authentication token, generated from admin area |

## Example request

```bash
curl -X GET "https://yoursite.com/api/subscriptions/" \
  -H "authtoken: YOUR_API_TOKEN"
```

## Success response

### Success-Response:

```json
HTTP/1.1 200 OK
[
    {
     'name' => varchar 'New  subscription'
     'description' => text 'This is a detailed description of subscription'
     'description_in_item' => tinyint '1'
     'clientid' => int '123'
     'date' => date '2024-01-31'
     'terms' => text 'subscription payment is due'
     'currency ' => int '4'
     'tax_id ' => int '456'
     'stripe_tax_id_2' => varchar 'tax-789' 
     'stripe_plan_id' => text 'subscription_ABC'
     'stripe_subscription_id' => text 'subscription_ABC'
     'tax_id_2': int '12',
     'stripe_subscription_id' => text 'sub_123456789'
     'next_billing_cycle' => bigint '1643808000'
     'ends_at' => bigint '1646486400'
     'status' => varchar 'active'
     'quantity' => int '5'
     'project_id' => int '789'
     'hash' => varchar 'a1b2c3' 
     'created' => datetime '2024-01-31 12:34:56'
     'created_from' => int '1' 
     'date_subscribed' => datetime '2024-01-31 10:00:00'
     'in_test_environment' => int '1' 
     'last_sent_at' => datetime '2024-01-31 14:45:00'
    }
]
```

## Error responses

### Error-Response:

```json
HTTP/1.1 404 Not Found
{
    "status": false,
    "message": "No data were found"
}
```

---

Perfex CRM REST API by Themesic Interactive. Full reference: /apiguide/