Back to Dashboard

API Documentation

Enterprise
Quick Navigation
Getting StartedAuthenticationRate LimitsAPI EndpointsCode ExamplesError Handling
Getting Started
Welcome to the I'm Calling Dibs API! This RESTful API allows Enterprise customers to programmatically access and manage their data.

Base URL

https://imcallingdibs.com/api/v1

Requirements

  • Enterprise subscription
  • Valid API key
  • HTTPS requests only
  • JSON request/response format
Authentication
All API requests require authentication using your API key.

API Key Authentication

Include your API key in the Authorization header of every request:

Authorization: Bearer your_api_key_here

Alternative format: Authorization: ApiKey your_api_key_here

Need an API key?

Generate API keys in your dashboard under Settings → API Access.

Rate Limits
API usage is rate limited to ensure fair usage and system stability.

Enterprise Tier

500

requests per minute

Standard Tier

100

requests per minute

Rate Limit Headers

X-RateLimit-Limit: Maximum requests per window

X-RateLimit-Remaining: Requests remaining in current window

X-RateLimit-Reset: Time when the rate limit resets

API Endpoints
Available endpoints for managing your data programmatically.
GET
/api/v1/items

Retrieve all items you have access to.

Query Parameters:

  • limit (optional): Number of items to return (max 100, default 50)
  • offset (optional): Number of items to skip (default 0)
  • categoryId (optional): Filter by category ID
POST
/api/v1/items

Create a new item.

Request Body:

{
  "name": "Beach House",
  "description": "Beautiful oceanfront property",
  "imageUrl": "https://example.com/image.jpg",
  "creditsPerUser": 8,
  "categoryId": "cat_123"
}
PUT
/api/v1/items/:id

Update an existing item (admin only).

DELETE
/api/v1/items/:id

Delete an item (admin only).

Code Examples
Example requests in different programming languages.

Get Items

curl -X GET "https://imcallingdibs.com/api/v1/items" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json"

Create Item

curl -X POST "https://imcallingdibs.com/api/v1/items" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Beach House",
    "description": "Beautiful oceanfront property",
    "creditsPerUser": 8
  }'
Error Handling
Understanding API error responses and status codes.

HTTP Status Codes

200 OKRequest successful
201 CreatedResource created successfully
400 Bad RequestInvalid request data
401 UnauthorizedInvalid or missing API key
403 ForbiddenInsufficient permissions
404 Not FoundResource not found
429 Too Many RequestsRate limit exceeded
500 Internal Server ErrorServer error

Error Response Format

{
  "success": false,
  "error": "Detailed error message",
  "code": "ERROR_CODE"
}
Need Help?
Enterprise customers get priority support for API integration.
Contact SupportEmail API Team