Skip to main content

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​

FieldTypeDescription
idintegerUnique identifier for the service/product
namestringName of the service or product
descriptionstringDetailed description of the service/product
typestringType of item ("service" or "product")
categorystringCategory classification
pricedecimalBase price of the service/product
currencystringCurrency code (e.g., USD, EUR)
billing_typestringHow the item is billed ("hourly", "fixed", "recurring")
is_activebooleanWhether the service/product is currently active
tax_ratedecimalTax rate percentage applied to this item
unitstringUnit of measurement (hours, project, month, etc.)
created_atdatetimeWhen the service/product was created
updated_atdatetimeWhen the service/product was last updated
custom_fieldsarrayArray of custom fields associated with this item
tagsarrayArray of tags for categorization and search

Service/Product Types​

TypeDescription
serviceIntangible services (consulting, development, etc.)
productTangible products or deliverables

Billing Types​

TypeDescription
hourlyBilled per hour worked
fixedOne-time fixed price
recurringRecurring subscription or retainer

Custom Fields Structure​

FieldTypeDescription
idintegerUnique identifier for the custom field
namestringDisplay name of the field
keystringUnique key for the field
valuemixedCurrent value of the field
typestringField type (text, number, select, etc.)

Query Parameters​

ParameterTypeDescriptionExample
pageintegerPage number for pagination?page=2
limitintegerNumber of items per page (max 100)?limit=25
typestringFilter by type (service/product)?type=service
categorystringFilter by category?category=Development
is_activebooleanFilter by active status?is_active=true
searchstringSearch in name and description?search=web
tagsstringFilter 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
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​

CodeDescription
200Success
400Bad Request (invalid parameters)
401Unauthorized
500Server 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.