Get All Services

Retrieve a list of all services and products.

Endpoint

GET /api/services/

Request

GET https://app.getmanageit.io/api/services/
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Response

{
  "data": [
    {
      "id": 1,
      "name": "Web Development",
      "description": "Custom web development services including frontend and backend development",
      "type": "service",
      "category": "Development",
      "price": 150.00,
      "currency": "USD",
      "billing_type": "hourly",
      "is_active": true,
      "tax_rate": 8.5,
      "unit": "hours",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z",
      "custom_fields": [
        {
          "id": 10,
          "name": "Complexity Level",
          "key": "complexity_level",
          "value": "Advanced",
          "type": "select"
        }
      ],
      "tags": ["web", "development", "frontend", "backend"]
    },
    {
      "id": 2,
      "name": "Logo Design",
      "description": "Professional logo design services",
      "type": "product",
      "category": "Design",
      "price": 500.00,
      "currency": "USD",
      "billing_type": "fixed",
      "is_active": true,
      "tax_rate": 8.5,
      "unit": "project",
      "created_at": "2024-01-16T14:22:00Z",
      "updated_at": "2024-01-16T14:22:00Z",
      "custom_fields": [
        {
          "id": 11,
          "name": "Revision Rounds",
          "key": "revision_rounds",
          "value": "3",
          "type": "number"
        }
      ],
      "tags": ["design", "logo", "branding"]
    },
    {
      "id": 3,
      "name": "SEO Consultation",
      "description": "Search engine optimization consultation and strategy",
      "type": "service",
      "category": "Marketing",
      "price": 200.00,
      "currency": "USD",
      "billing_type": "hourly",
      "is_active": true,
      "tax_rate": 8.5,
      "unit": "hours",
      "created_at": "2024-01-17T09:15:00Z",
      "updated_at": "2024-01-17T09:15:00Z",
      "custom_fields": [],
      "tags": ["seo", "marketing", "consultation"]
    },
    {
      "id": 4,
      "name": "Website Hosting",
      "description": "Monthly website hosting service",
      "type": "service",
      "category": "Hosting",
      "price": 29.99,
      "currency": "USD",
      "billing_type": "recurring",
      "is_active": true,
      "tax_rate": 8.5,
      "unit": "month",
      "created_at": "2024-01-18T11:45:00Z",
      "updated_at": "2024-01-18T11:45:00Z",
      "custom_fields": [
        {
          "id": 12,
          "name": "Storage Limit",
          "key": "storage_limit",
          "value": "10GB",
          "type": "text"
        }
      ],
      "tags": ["hosting", "monthly", "recurring"]
    }
  ],
  "meta": {
    "total": 4,
    "page": 1,
    "limit": 10,
    "total_pages": 1
  },
  "timestamp": "2024-01-15T10:30:00Z"
}

Response Fields

Field	Type	Description
id	integer	Unique identifier for the service/product
name	string	Name of the service or product
description	string	Detailed description of the service/product
type	string	Type of item ("service" or "product")
category	string	Category classification
price	decimal	Base price of the service/product
currency	string	Currency code (e.g., USD, EUR)
billing_type	string	How the item is billed ("hourly", "fixed", "recurring")
is_active	boolean	Whether the service/product is currently active
tax_rate	decimal	Tax rate percentage applied to this item
unit	string	Unit of measurement (hours, project, month, etc.)
created_at	datetime	When the service/product was created
updated_at	datetime	When the service/product was last updated
custom_fields	array	Array of custom fields associated with this item
tags	array	Array of tags for categorization and search

Service/Product Types

Type	Description
service	Intangible services (consulting, development, etc.)
product	Tangible products or deliverables

Billing Types

Type	Description
hourly	Billed per hour worked
fixed	One-time fixed price
recurring	Recurring subscription or retainer

Custom Fields Structure

Field	Type	Description
id	integer	Unique identifier for the custom field
name	string	Display name of the field
key	string	Unique key for the field
value	mixed	Current value of the field
type	string	Field type (text, number, select, etc.)

Query Parameters

Parameter	Type	Description	Example
page	integer	Page number for pagination	?page=2
limit	integer	Number of items per page (max 100)	?limit=25
type	string	Filter by type (service/product)	?type=service
category	string	Filter by category	?category=Development
is_active	boolean	Filter by active status	?is_active=true
search	string	Search in name and description	?search=web
tags	string	Filter by tags (comma-separated)	?tags=web,development

Example Requests

Get all services only

GET https://app.getmanageit.io/api/services/?type=service
Authorization: Bearer YOUR_API_KEY

Search for web-related services

GET https://app.getmanageit.io/api/services/?search=web&is_active=true
Authorization: Bearer YOUR_API_KEY

Get services with pagination

GET https://app.getmanageit.io/api/services/?page=2&limit=5
Authorization: Bearer YOUR_API_KEY

Filter by category and tags

GET https://app.getmanageit.io/api/services/?category=Development&tags=frontend,backend
Authorization: Bearer YOUR_API_KEY

Status Codes

Code	Description
200	Success
400	Bad Request (invalid parameters)
401	Unauthorized
500	Server Error

Error Response

{
  "error": {
    "message": "Invalid request parameters",
    "code": "INVALID_PARAMETERS",
    "details": {
      "limit": "Limit must be between 1 and 100"
    }
  },
  "timestamp": "2024-01-15T10:30:00Z"
}

---

For more information about services and products management, see our Services & Products Guide.