MOCO API

https://everii-group.github.io/mocoapp-api-docs
Admin
MOCO API is a RESTful API for mocoapp.com that provides programmatic access to project management,...
Tokens:107,881
Snippets:667
Trust Score:8.3
Update:1 week ago
Show doc for...
Tokens:
Raw
### GET /account/hourly_rates - Example response

Source: https://everii-group.github.io/mocoapp-api-docs/sections/account/hourly_rates.html

Example response from the GET /account/hourly_rates endpoint. Contains default rates, task-specific rates, and user-specific rates, each with currency and hourly_rate fields.

```json
{
  "defaults_rates": [
    { "currency": "CHF", "hourly_rate": 160.0 },
    { "currency": "EUR", "hourly_rate": 150.0 },
    { "currency": "USD", "hourly_rate": 160.0 }
  ],
  "tasks": [
    {
      "id": 5004,
      "name": "Grafik",
      "rates": [
        { "currency": "CHF", "hourly_rate": 160.0 },
        { "currency": "EUR", "hourly_rate": 150.0 },
        { "currency": "USD", "hourly_rate": 160.0 }
      ]
    },
    {
      "id": 5005,
      "name": "Entwicklung",
      "rates": [
        { "currency": "CHF", "hourly_rate": 160.0 },
        { "currency": "EUR", "hourly_rate": 150.0 },
        { "currency": "USD", "hourly_rate": 160.0 }
      ]
    },
    {
      "id": 5006,
      "name": "Projektleitung",
      "rates": [
        { "currency": "CHF", "hourly_rate": 170.0 },
        { "currency": "EUR", "hourly_rate": 160.0 },
        { "currency": "USD", "hourly_rate": 170.0 }
      ]
    }
  ],
  "users": [
    {
      "id": 933589840,
      "full_name": "Max Muster",
      "rates": [
        { "currency": "CHF", "hourly_rate": 160.0 },
        { "currency": "EUR", "hourly_rate": 150.0 },
        { "currency": "USD", "hourly_rate": 160.0 }
      ]
    },
    {
      "id": 933589844,
      "full_name": "Peter Müller",
      "rates": [
        { "currency": "CHF", "hourly_rate": 180.0 },
        { "currency": "EUR", "hourly_rate": 170.0 },
        { "currency": "USD", "hourly_rate": 180.0 }
      ]
    }
  ]
}
```

--------------------------------

### GET /account/internal_hourly_rates - Example response

Source: https://everii-group.github.io/mocoapp-api-docs/sections/account/internal_hourly_rates.html

Example JSON response returned by the GET endpoint, showing a list of users with their hourly rates for each year.

```json
[
  {
    "id": 933589613,
    "full_name": "Daniela Demo",
    "rates": [
      {
        "year": 2020,
        "rate": 120.0
      },
      {
        "year": 2021,
        "rate": 130.0
      }
    ]
  },
  {
    "id": 933618769,
    "full_name": "Max Muster",
    "rates": [
      {
        "year": 2020,
        "rate": 110.0
      },
      {
        "year": 2021,
        "rate": 120.0
      }
    ]
  }
]

```

--------------------------------

### GET /api/v1/projects (with Token authentication)

Source: https://everii-group.github.io/mocoapp-api-docs/authentication.html

Example of authenticating a request to list projects using a token in the Authorization header.

```APIDOC
## GET /api/v1/projects

### Description
Example request to the projects list endpoint using token authentication.

### Method
GET

### Endpoint
https://{domain}.mocoapp.com/api/v1/projects

### Headers
- **Authorization** (string) - Required - Format: `Token token=YOUR_API_KEY`

### Request Example
```
curl -X GET \
  'https://{domain}.mocoapp.com/api/v1/projects' \
  -H 'Authorization: Token token=YOUR_API_KEY'
```
```

--------------------------------

### Planning entry full representation example

Source: https://everii-group.github.io/mocoapp-api-docs/sections/planning_entries.html

Example JSON object showing the complete planning entry representation with standard fields, user, project, task, and deal attributes. The deal is null when a project is assigned.

```json
{
  "id": 4839,
  "title": "Project Management",
  "starts_on": "2020-05-04",
  "ends_on": "2020-05-04",
  "hours_per_day": 6.0,
  "comment": "",
  "symbol": null,
  "color": "#2965cc",
  "read_only": false,
  "user": {
    "id": 5484,
    "firstname": "Thomas",
    "lastname": "Munster"
  },
  "project": {
    "id": 4553,
    "identifier": "130",
    "name": "Support",
    "customer_name": "Acme GmbH",
    "color": "#faeb44"
  },
  "task": {
    "id": 6789,
    "name": "Projektleitung"
  },
  "deal": null,
  "series_id": null,
  "tentative": false,
  "series_repeat": null,
  "created_at": "2018-10-17T09:33:46Z",
  "updated_at": "2018-10-17T09:33:46Z"
}
```

--------------------------------

### Planning entry deal attributes example

Source: https://everii-group.github.io/mocoapp-api-docs/sections/planning_entries.html

Example JSON object showing the deal attributes included in a planning entry representation. The deal is set to null when a project is assigned.

```json
{
  "id": 6542,
  "name": "Redesign website",
  "customer_name": "Acme GmbH",
  "color": "#aacb84"
}
```

--------------------------------

### Presence object example

Source: https://everii-group.github.io/mocoapp-api-docs/sections/presences.html

Example JSON representation of a presence object, showing standard fields plus the nested user object.

```json
{
  "id": 982237015,
  "date": "2018-07-03",
  "from": "07:30",
  "to": "13:15",
  "is_home_office": true,
  "user": {
    "id": 933590696,
    "firstname": "John",
    "lastname": "Doe"
  },
  "created_at": "2018-10-17T09:33:46Z",
  "updated_at": "2018-10-17T09:33:46Z"
}
```

--------------------------------

### GET /projects

Source: https://everii-group.github.io/mocoapp-api-docs/sections/projects

Retrieves a list of all projects.

```APIDOC
## [GET] /projects

### Description
Retrieves a list of all projects.

### Method
GET

### Endpoint
/projects

```

--------------------------------

### GET /api/v1/projects (with Bearer authentication)

Source: https://everii-group.github.io/mocoapp-api-docs/authentication.html

Example of authenticating a request to list projects using a bearer token in the Authorization header.

```APIDOC
## GET /api/v1/projects

### Description
Example request to the projects list endpoint using bearer token authentication.

### Method
GET

### Endpoint
https://{domain}.mocoapp.com/api/v1/projects

### Headers
- **Authorization** (string) - Required - Format: `Bearer YOUR_API_KEY`

### Request Example
```
curl -X GET \
  'https://{domain}.mocoapp.com/api/v1/projects' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```
```

--------------------------------

### GET /report/finance response

Source: https://everii-group.github.io/mocoapp-api-docs/sections/reports.html

Example response for the finance report endpoint. Returns an array of report entries with record, company, user, and date fields.

```json
[
  {
    "record_id": 3731655,
    "company_id": 760718470,
    "description":"ZL 1",
    "user_id": 933621267,
    "net_amount_in_account_currency": 100.0,
    "kind": "incoming_expenses",
    "company": {
      "id": 762768470,
      "name":"Maus AG"
    },
    "user": {
      "id":933621267,
      "firstname": "Jenni",
      "lastname": "Doe"
    },
    "date":"2025-03-27"
  }
]

```

--------------------------------

### Receipt object JSON example

Source: https://everii-group.github.io/mocoapp-api-docs/sections/receipts.html

Example of a receipt object returned by the API. Includes standard fields plus nested items with VAT, purchase category, and project information.

```json
{
  "id": 123,
  "title": "Team-Lunch",
  "date": "2021-12-13",
  "billable": false,
  "pending": false,
  "gross_total": 56.5,
  "currency": "CHF",
  "items": [
    {
      "gross_total": 56.5,
      "vat": {
        "id": 186,
        "tax": 7.7,
        "reverse_charge": false,
        "intra_eu": false
      },
      "purchase_category": {
        "id": 2684,
        "name": "Bewirtungsaufwände"
      }
    }
  ],
  "project": {
    "id": 567,
    "name": "Intern/Admin",
    "billable": false,
    "company": {
      "id": 789,
      "name": "Example Company"
    }
  }
}
```

--------------------------------

### Team object attributes example

Source: https://everii-group.github.io/mocoapp-api-docs/sections/units.html

Shows the JSON representation of a team (unit) with its standard fields plus the users array of assigned staff. The example includes id, name, users with id, firstname, lastname, email, created_at, and updated_at.

```json
{
  "id": 909147861,
  "name": "C Office",
  "users": [
    {
      "id": 933590158,
      "firstname": "Tobias",
      "lastname": "Miesel",
      "email": "tobias@domain.com"
    },
    {
      "id": 933589599,
      "firstname": "Sabine",
      "lastname": "Schäuble",
      "email": "sabine@domain.com"
    }
  ],
  "created_at": "2018-10-17T09:33:46Z",
  "updated_at": "2018-10-17T09:33:46Z"
}
```

--------------------------------

### PATCH /activities/{id}/start_timer

Source: https://everii-group.github.io/mocoapp-api-docs/sections/activities.html

Starts the timer for an activity.

```APIDOC
## PATCH /activities/{id}/start_timer

### Description
Starts the timer for an activity.

### Method
PATCH

### Endpoint
/activities/{id}/start_timer

### Parameters
#### Path Parameters
- **id** (integer) - Required - The ID of the activity

### Response
#### Success Response (200)
- **activity** (object) - The activity with timer started

#### Response Example
```json
{
  "id": 982237015,
  "date": "2018-07-03",
  "hours": 1.25,
  "seconds": 4500,
  "worked_seconds": 4500,
  "description": "Analysis context and dependencies",
  "billed": false,
  "invoice_id": null,
  "billable": false,
  "tag": "",
  "remote_service": "trello",
  "remote_id": "9qzOS8AA",
  "remote_url": "https://trello.com/c/9qzOS8AA/123-analyse",
  "project": {
    "id": 944587499,
    "name": "Website Relaunch",
    "billable": false
  },
  "task": {
    "id": 658636,
    "name": "Concept",
    "billable": false
  },
  "customer": {
    "id": 760253684,
    "name": "Example Inc."
  },
  "user": {
    "id": 933590696,
    "firstname": "John",
    "lastname": "Doe"
  },
  "hourly_rate": 150,
  "timer_started_at": "2018-10-17T09:33:46Z",
  "created_at": "2018-10-17T09:33:46Z",
  "updated_at": "2018-10-17T09:33:46Z"
}
```
```

--------------------------------

### GET /api/v1/session

Source: https://everii-group.github.io/mocoapp-api-docs/authentication.html

Verify if the API key is still valid.

```APIDOC
## GET /api/v1/session

### Description
Checks the validity of the API key. Returns 200 OK with user details if valid, otherwise 401 Unauthorized.

### Method
GET

### Endpoint
https://{domain}.mocoapp.com/api/v1/session

### Headers
- **Accept** (string) - Required - `application/json`
- **Content-Type** (string) - Required - `application/json`

### Response
#### Success Response (200)
- **id** (integer) - User ID
- **uuid** (string) - User UUID

#### Response Example
```
{
  "id": 123,
  "uuid": "aec324a2-4832-11eb-b378-0242ac130002"
}
```

#### Error Response (401)
- Description: Unauthorized - invalid API key
```

--------------------------------

### POST /deals - Create a lead

Source: https://everii-group.github.io/mocoapp-api-docs/sections/deals.html

Creates a new lead. Mandatory fields: name, currency, money, reminder_date, user_id, deal_category_id. Optional fields include company_id, person_id, info, status (default 'pending'), closed_on, service_period_from (must be first of month), service_period_to (must be last of month), and tags.

```bash
curl -X POST \
  'https://{domain}.mocoapp.com/api/v1/deals' \
  -H 'Authorization: Token token=YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
        "name": "Beispiel AG Website Relaunch",
        "currency": "EUR",
        "money": 25000,
        "reminder_date": "2018-12-01",
        "user_id": 123,
        "deal_category_id": 456,
      }'
```

--------------------------------

### Create customer with custom property (string value)

Source: https://everii-group.github.io/mocoapp-api-docs/custom_fields.html

Example of creating a customer with a custom property. Parameters are sent with their name as key. All values are encoded as strings.

```bash
curl -X POST \
  https://{domain}.mocoapp.com/api/v1/customers \
  -H 'Authorization: Token token=YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Beispiel AG",
    "currency": "CHF",
    "custom_properties": {
      "Line of business": "Automotive"
    }
  }'
```

--------------------------------

### GET /profile response

Source: https://everii-group.github.io/mocoapp-api-docs/sections/profile.html

Example JSON response returned by the GET /profile endpoint. Contains the user's profile data including id, email, full name, active status, avatar URL, unit, and timestamps.

```json
{
  "id": 237852983,
  "email": "janine.kuesters@meinefirma.de",
  "full_name": "Janine Küsters",
  "first_name": "Janine",
  "last_name": "Küsters",
  "active": true,
  "external": false,
  "avatar_url": "https://data.mocoapp.com/objects/6bf3db0a-895a-46a1-8006-6280af04b9c0.jpg",
  "unit": {
    "id": 436796,
    "name": "Design"
  },
  "created_at": "2018-10-17T09:33:46Z",
  "updated_at": "2022-08-02T14:21:56Z"
}
```

--------------------------------

### Activity object JSON example

Source: https://everii-group.github.io/mocoapp-api-docs/sections/activities.html

Shows the structure of an activity object with standard and extended attributes, including project, task, customer, user, and remote service fields. The `timer_started_at` field is null when no timer is running.

```json
{
  "id": 982237015,
  "date": "2018-07-03",
  "hours": 1.25,
  "seconds": 4500,
  "worked_seconds": 4500,
  "description": "Analysis context and dependencies",
  "billed": false,
  "invoice_id": null,
  "billable": false,
  "tag": "",
  "remote_service": "trello",
  "remote_id": "9qzOS8AA",
  "remote_url": "https://trello.com/c/9qzOS8AA/123-analyse",
  "project": {
    "id": 944587499,
    "name": "Website Relaunch",
    "billable": false
  },
  "task": {
    "id": 658636,
    "name": "Concept",
    "billable": false
  },
  "customer": {
    "id": 760253684,
    "name": "Example Inc."
  },
  "user": {
    "id": 933590696,
    "firstname": "John",
    "lastname": "Doe"
  },
  "hourly_rate": 150,
  "timer_started_at": null,
  "created_at": "2018-10-17T09:33:46Z",
  "updated_at": "2018-10-17T09:33:46Z"
}
```

--------------------------------

### Retrieve project report with GET /projects/{id}/report

Source: https://everii-group.github.io/mocoapp-api-docs/sections/projects

Retrieves a project report containing key business indicators. The response includes budget, invoiced, hours, costs, and a breakdown by task. All costs are in the account's main currency, which may differ from the budget and billable items.

```bash
curl -X GET \
  'https://{domain}.mocoapp.com/api/v1/projects/{id}/report' \
  -H 'Authorization: Token token=YOUR_API_KEY'

```

```json
{
  "budget_total": 50000.0,
  "budget_progress_in_percentage": 50,
  "budget_remaining": 25.0,
  "invoiced_total": 27885.0,
  "currency": "EUR",
  "hours_total": 1500,
  "hours_billable": 1340,
  "hours_remaining": 1500,
  "costs_expenses": 4000.0,
  "costs_activities": 16450.0,
  "costs_by_task": [
    {
      "id": 7536,
      "name": "Project Management",
      "hours_total": 12.5,
      "total_costs": 725.0
    },
    {
      "id": 7239,
      "name": "Design",
      "hours_total": 71.98,
      "total_costs": 5598.0
    },
    {
      "id": 573376,
      "name": "Development",
      "hours_total": 94.48,
      "total_costs": 9448.0
    }
  ]
}

```

--------------------------------

### GET /report/finance - curl request

Source: https://everii-group.github.io/mocoapp-api-docs/sections/reports.html

Retrieves the finance report. Supports optional from, to, and term filters; from and to default to the start and end of the current year when omitted.

```bash
curl -X GET \
  'https://{domain}.mocoapp.com/api/v1/report/finance' \
  -H 'Authorization: Token token=YOUR_API_KEY'

```

--------------------------------

### GET /taggings - Retrieve tags for an entity

Source: https://everii-group.github.io/mocoapp-api-docs/sections/tags/taggings.html

Retrieves the list of tags associated with the specified entity. The response is an array of tag names, for example ["cool", "on hold"].

```bash
curl -X GET \
  'https://{domain}.mocoapp.com/api/v1/taggings/Project/357'

```

--------------------------------

### cURL request for utilization report

Source: https://everii-group.github.io/mocoapp-api-docs/sections/reports.html

Sends a GET request to the utilization report endpoint. The from and to query parameters filter the report by date range, defaulting to the start and end of the current year when omitted.

```bash
curl -X GET \
  'https://{domain}.mocoapp.com/api/v1/report/utilization?from={from_date}&to={to_date}' \
  -H 'Authorization: Token token=YOUR_API_KEY'

```

--------------------------------

### GET /offers - Retrieve all offers

Source: https://everii-group.github.io/mocoapp-api-docs/sections/offers.html

Retrieves all offers. The response is an array with complete offer information except for salutation, footer, and items.

```bash
curl -X GET \
  'https://{domain}.mocoapp.com/api/v1/offers' \
  -H 'Authorization: Token token=YOUR_API_KEY'

```

--------------------------------

### GET /account/catalog_services/{service_id}/items/{id}

Source: https://everii-group.github.io/mocoapp-api-docs/sections/account/catalog_services.html

Gets a specific item within a catalog service.

```APIDOC
## GET /account/catalog_services/{service_id}/items/{id}

### Description
Retrieves an item within a catalog service.

### Method
GET

### Endpoint
https://{domain}.mocoapp.com/api/v1/account/catalog_services/{service_id}/items/{id}

### Parameters
#### Path Parameters
- **service_id** (string) - Required - The ID of the catalog service.
- **id** (string) - Required - The ID of the item to retrieve.

### Request Example
```
curl -X GET \
  'https://{domain}.mocoapp.com/api/v1/account/catalog_services/{service_id}/items/{id}' \
  -H 'Authorization: Token token=YOUR_API_KEY'
```

### Response
No response body is documented.
```

--------------------------------

### POST /projects

Source: https://everii-group.github.io/mocoapp-api-docs/sections/projects

Creates a new project with the provided attributes.

```APIDOC
## [POST] /projects

### Description
Creates a new project.

### Method
POST

### Endpoint
/projects
```

--------------------------------

### GET /report/cashflow - Retrieve cashflow report

Source: https://everii-group.github.io/mocoapp-api-docs/sections/reports.html

Retrieves the cashflow report using a GET request to the MOCO API.

```bash
curl -X GET \
  'https://{domain}.mocoapp.com/api/v1/report/cashflow' \
  -H 'Authorization: Token token=YOUR_API_KEY'
```

--------------------------------

### Role attributes JSON example

Source: https://everii-group.github.io/mocoapp-api-docs/sections/user_roles.html

Example JSON representation of a user role, including the permission object with various access levels.

```json
{
  "id": 42,
  "name": "Entwickler",
  "is_default": false,
  "is_admin": false,
  "permission": {
    "report": "none",
    "companies": "full",
    "contacts": "full",
    "people": "none",
    "purchases": "none",
    "settings": "none",
    "sales": "none",
    "projects": "full",
    "calendar": "full",
    "time_tracking": "full",
    "invoicing": "none"
  },
  "created_at": "2024-10-17T09:33:46Z",
  "updated_at": "2024-10-17T09:33:46Z"
}
```

--------------------------------

### POST /activities

Source: https://everii-group.github.io/mocoapp-api-docs/sections/activities.html

Creates a new activity.

```APIDOC
## POST /activities

### Description
Creates a new activity.

### Method
POST

### Endpoint
/activities

### Parameters
#### Request Body
- **date** (string) - Required - The date of the activity (YYYY-MM-DD)
- **hours** (number) - Optional - The hours of the activity
- **seconds** (integer) - Optional - The billable seconds of the activity
- **description** (string) - Optional - Description of the activity
- **project_id** (integer) - Optional - The ID of the project
- **task_id** (integer) - Optional - The ID of the task
- **customer_id** (integer) - Optional - The ID of the customer
- **billable** (boolean) - Optional - Whether the activity is billable
- **tag** (string) - Optional - Tag for the activity
- **remote_service** (string) - Optional - External service name
- **remote_id** (string) - Optional - External service ID
- **remote_url** (string) - Optional - External service URL

### Request Example
```json
{
  "date": "2018-07-03",
  "hours": 1.25,
  "description": "Analysis context and dependencies",
  "project_id": 944587499,
  "task_id": 658636,
  "customer_id": 760253684,
  "billable": false
}
```

### Response
#### Success Response (201)
- **activity** (object) - The created activity

#### Response Example
```json
{
  "id": 982237015,
  "date": "2018-07-03",
  "hours": 1.25,
  "seconds": 4500,
  "worked_seconds": 4500,
  "description": "Analysis context and dependencies",
  "billed": false,
  "invoice_id": null,
  "billable": false,
  "tag": "",
  "remote_service": "trello",
  "remote_id": "9qzOS8AA",
  "remote_url": "https://trello.com/c/9qzOS8AA/123-analyse",
  "project": {
    "id": 944587499,
    "name": "Website Relaunch",
    "billable": false
  },
  "task": {
    "id": 658636,
    "name": "Concept",
    "billable": false
  },
  "customer": {
    "id": 760253684,
    "name": "Example Inc."
  },
  "user": {
    "id": 933590696,
    "firstname": "John",
    "lastname": "Doe"
  },
  "hourly_rate": 150,
  "timer_started_at": null,
  "created_at": "2018-10-17T09:33:46Z",
  "updated_at": "2018-10-17T09:33:46Z"
}
```
```

--------------------------------

### List all attachments for an offer (GET /offers/{id}/attachments)

Source: https://everii-group.github.io/mocoapp-api-docs/sections/offers.html

Use this endpoint to retrieve all attachments associated with a specific offer. The request requires a valid API key in the Authorization header. The response contains the list of attachments for the given offer.

```bash
curl -X GET \
  'https://{domain}.mocoapp.com/api/v1/offers/{offer_id}/attachments' \
  -H 'Authorization: Token token=YOUR_API_KEY'

```

--------------------------------

### POST /activities/bulk

Source: https://everii-group.github.io/mocoapp-api-docs/sections/activities.html

Creates multiple activities in bulk.

```APIDOC
## POST /activities/bulk

### Description
Creates multiple activities in bulk.

### Method
POST

### Endpoint
/activities/bulk

### Parameters
#### Request Body
- **activities** (array) - Required - Array of activity objects to create

### Request Example
```json
{
  "activities": [
    {
      "date": "2018-07-03",
      "hours": 1.25,
      "description": "Analysis context and dependencies",
      "project_id": 944587499,
      "task_id": 658636,
      "customer_id": 760253684,
      "billable": false
    }
  ]
}
```

### Response
#### Success Response (201)
- **activities** (array) - List of created activities

#### Response Example
```json
[
  {
    "id": 982237015,
    "date": "2018-07-03",
    "hours": 1.25,
    "seconds": 4500,
    "worked_seconds": 4500,
    "description": "Analysis context and dependencies",
    "billed": false,
    "invoice_id": null,
    "billable": false,
    "tag": "",
    "remote_service": "trello",
    "remote_id": "9qzOS8AA",
    "remote_url": "https://trello.com/c/9qzOS8AA/123-analyse",
    "project": {
      "id": 944587499,
      "name": "Website Relaunch",
      "billable": false
    },
    "task": {
      "id": 658636,
      "name": "Concept",
      "billable": false
    },
    "customer": {
      "id": 760253684,
      "name": "Example Inc."
    },
    "user": {
      "id": 933590696,
      "firstname": "John",
      "lastname": "Doe"
    },
    "hourly_rate": 150,
    "timer_started_at": null,
    "created_at": "2018-10-17T09:33:46Z",
    "updated_at": "2018-10-17T09:33:46Z"
  }
]
```
```

--------------------------------

### GET /purchases

Source: https://everii-group.github.io/mocoapp-api-docs/sections/purchases.html

Retrieves a list of purchases.

```APIDOC
## GET /purchases

### Description
Retrieves a list of purchases.

### Method
GET

### Endpoint
/purchases

### Parameters
#### Query Parameters
- **page** (integer) - Optional - Page number for pagination.
- **per_page** (integer) - Optional - Number of items per page.

### Response
#### Success Response (200)
- **purchases** (array) - List of purchase objects.

#### Response Example
{
  "purchases": [
    {
      "id": 987,
      "identifier": "E2016-0001",
      "title": "SBB Ticket",
      "status": "pending",
      "gross_total": 46.0,
      "currency": "CHF"
    }
  ]
}
```

--------------------------------

### GET /deals - Retrieve all leads

Source: https://everii-group.github.io/mocoapp-api-docs/sections/deals.html

Retrieves all leads. Supports global filters and additional parameters: status, tags, closed_from/closed_to, and company_id. Returns an array with complete lead information.

```bash
curl -X GET \
  'https://{domain}.mocoapp.com/api/v1/deals' \
  -H 'Authorization: Token token=YOUR_API_KEY'
```

--------------------------------

### POST /users/presences - create a presence

Source: https://everii-group.github.io/mocoapp-api-docs/sections/presences.html

Creates a presence for the user associated with the API key. The 'date' and 'from' fields are mandatory; 'to' can be left blank.

```bash
curl -X POST \
  'https://{domain}.mocoapp.com/api/v1/users/presences' \
  -H 'Authorization: Token token=YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
        "date": "2018-06-11",
        "from": "08:00",
        "to": "10:00"
      }'
```

--------------------------------

### GET /invoices

Source: https://everii-group.github.io/mocoapp-api-docs/sections/invoices.html

Retrieves a list of invoices.

```APIDOC
## [GET] /invoices

### Description
Retrieves a list of all invoices.

### Method
GET

### Endpoint
/invoices

### Parameters
None

### Response
#### Success Response (200)
- **invoices** (array) - List of invoice objects

#### Response Example
{
  "invoices": []
}
```

--------------------------------

### Create a staff member with curl POST /users

Source: https://everii-group.github.io/mocoapp-api-docs/sections/users.html

Creates a staff member by sending a POST request to the /users endpoint. The request body must include the mandatory fields firstname, lastname, email, and unit_id; the example also supplies password. The response is not shown in the source.

```bash
curl -X POST \
  'https://{domain}.mocoapp.com/api/v1/users' \
  -H 'Authorization: Token token=YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
        "firstname": "Carmen",
        "lastname": "Sandiego",
        "email": "carmen.sandiego@acme.corp",
        "password": "dAfsdf88fw8fKjtD28f293!",
        "unit_id": 123
      }'

```

--------------------------------

### Bulk insert activities with POST /activities/bulk

Source: https://everii-group.github.io/mocoapp-api-docs/sections/activities.html

Sends a POST request to bulk insert multiple activities. The request body contains an array of activity objects, each with date, description, project_id, task_id, and seconds. Requires an Authorization header with a valid API token.

```bash
curl -X POST \
  'https://{domain}.mocoapp.com/api/v1/activities/bulk' \
  -H 'Authorization: Token token=YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
        "activities": [
          {
            "date": "2023-08-21",
            "description": "Activity 1",
            "project_id": 123456,
            "task_id": 234567,
            "seconds": 3600
          },
          {
            "date": "2023-08-21",
            "description": "Activity 2",
            "project_id": 123456,
            "task_id": 234567,
            "seconds": 7200
          }
        ]
      }'
```

--------------------------------

### GET /account/hourly_rates - Retrieve hourly rates

Source: https://everii-group.github.io/mocoapp-api-docs/sections/account/hourly_rates.html

Retrieves hourly rates from the MOCO API. Requires a valid API key. Optional parameters: company_id (to get customer-specific rates) and include_archived_users (to include deactivated users, default false).

```bash
curl -X GET \
  'https://{domain}.mocoapp.com/api/v1/account/hourly_rates' \
  -H 'Authorization: Token token=YOUR_API_KEY'

```

--------------------------------

### GET /purchases/budgets - curl request

Source: https://everii-group.github.io/mocoapp-api-docs/sections/purchase_budgets.html

Retrieves purchase budgets for a given year using the GET /purchases/budgets endpoint. The year parameter is required and should be supplied as a query parameter. The response is an array of complete budget objects as described in the attributes section.

```bash
curl -X GET \
  'https://{domain}.mocoapp.com/api/v1/purchases/budgets?year=2023' \
  -H 'Authorization: Token token=YOUR_API_KEY'

```

--------------------------------

### POST /planning_entries - Create a planning entry

Source: https://everii-group.github.io/mocoapp-api-docs/sections/planning_entries.html

Curl command to create a planning entry. The entry is created with the user executing the request unless user_id is supplied. Mandatory fields: project_id or deal_id, starts_on, ends_on, hours_per_day.

```bash
curl -X POST \
  'https://{domain}.mocoapp.com/api/v1/planning_entries' \
  -H 'Authorization: Token token=YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
        "project_id": 4322,
        "task_id": 6789,
        "title": "Project Management",
        "starts_on": "2020-05-20",
        "ends_on": "2020-05-30",
        "hours_per_day": 3,
        "comment": "A comment...",
        "symbol": 2
      }'
```

--------------------------------

### Archive a project with PUT /projects/{id}/archive

Source: https://everii-group.github.io/mocoapp-api-docs/sections/projects

Archives a project by sending a PUT request to the archive endpoint.

```bash
curl -X PUT \
  'https://{domain}.mocoapp.com/api/v1/projects/{id}/archive' \
  -H 'Authorization: Token token=YOUR_API_KEY' \
  -H 'Content-Type: application/json'

```

--------------------------------

### Contact attributes JSON example

Source: https://everii-group.github.io/mocoapp-api-docs/sections/contacts.html

Shows the JSON structure of a contact object with standard fields plus tags and company. Use it to understand the shape of data returned by the Contacts API. The example includes a company sub-object and an avatar URL.

```json
{
  "id": 123,
  "gender": "M",
  "firstname": "Peter",
  "lastname": "Muster",
  "title": "Dr. med.",
  "job_position": "Account Manager",
  "mobile_phone": "+41 123 45 67",
  "work_fax": "",
  "work_phone": "+41 445 45 67",
  "work_email": "peter.muster@beispiel.ch",
  "work_address": "Beispiel AG\nPeter Muster\nBeispielstrasse 123",
  "home_email": "",
  "home_address": "",
  "birthday": "1959-05-22",
  "info": "",
  "avatar_url": "https//meinefirma.mocoapp.com/.../profil.jpg",
  "tags": ["Key Account", "Christmas Card"],
  "company": {
    "id": 123456,
    "name": "Beispiel AG"
  }
}
```

--------------------------------

### Purchase budget JSON representation

Source: https://everii-group.github.io/mocoapp-api-docs/sections/purchase_budgets.html

Example JSON object showing the structure of a purchase budget with fields for id, year, title, active status, target, exhausted, planned, and remaining amounts.

```json
{
    "id": "2",
    "year": 2024,
    "title": "Betrieb – Hosting",
    "active": true,
    "target": 84000,
    "exhaused": 66483,
    "planned": 4494,
    "remaining": 13023
}
```

--------------------------------

### POST /companies - Create a company

Source: https://everii-group.github.io/mocoapp-api-docs/sections/companies.html

Creates a new company with a JSON payload. The example shows a company named "Beispiel AG" with currency EUR.

```bash
curl -X POST \
  'https://{domain}.mocoapp.com/api/v1/companies' \
  -H 'Authorization: Token token=YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
        "name": "Beispiel AG",
        "currency": "EUR"
      }'
```

--------------------------------

### Invoice Reminder JSON representation

Source: https://everii-group.github.io/mocoapp-api-docs/sections/invoice_reminders.html

Example of the invoice reminder representation containing standard fields and shortened invoice information. The status field can be `created` or `sent`. The example shows a German-language reminder with a fee, dates, and a nested invoice object.

```json
{
  "id": 1,
  "title": "Zahlungserinnerung",
  "text": "Bei der Bearbeitung unserer Buchhaltung ist uns aufgefallen, dass wir für folgende Rechnung noch keinen Zahlungseingang verbuchen konnten. Sicherlich handelt es sich hierbei um ein Versehen. Wir bitten Sie höflich, uns den Betrag in den nächsten Tagen zu überweisen. Sollte sich Ihre Zahlung mit diesem Schreiben gekreuzt haben, betrachten Sie diese Erinnerung als gegenstandslos.",
  "fee": 0.0,
  "date": "2019-10-16",
  "due_date": "2019-10-30",
  "status": "created",
  "file_url": "https://...",
  "invoice": {
    "id": 148
  }
}
```

--------------------------------

### PUT /account/web_hooks/{id}/enable

Source: https://everii-group.github.io/mocoapp-api-docs/sections/web_hooks

Enables the web hook. If already enabled, it does nothing.

```bash
curl -X PUT \
  'https://{domain}.mocoapp.com/api/v1/account/web_hooks/{id}/enable' \
  -H 'Authorization: Token token=YOUR_API_KEY'
```

--------------------------------

### GET /units

Source: https://everii-group.github.io/mocoapp-api-docs/sections/units.html

Retrieve all teams from the MOCO API.

```APIDOC
## GET /units

### Description
Retrieve all teams.

### Method
GET

### Endpoint
https://{domain}.mocoapp.com/api/v1/units

### Parameters
#### Query Parameters
- Global filters apply

### Request Example
```
curl -X GET \
  'https://{domain}.mocoapp.com/api/v1/units' \
  -H 'Authorization: Token token=YOUR_API_KEY'
```

### Response
#### Success Response (200)
Returns an array with complete team information (see Attributes).

#### Response Example
```
{
  "id": 909147861,
  "name": "C Office",
  "users": [
    {
      "id": 933590158,
      "firstname": "Tobias",
      "lastname": "Miesel",
      "email": "tobias@domain.com"
    },
    {
      "id": 933589599,
      "firstname": "Sabine",
      "lastname": "Schäuble",
      "email": "sabine@domain.com"
    }
  ],
  "created_at": "2018-10-17T09:33:46Z",
  "updated_at": "2018-10-17T09:33:46Z"
}
```
```

--------------------------------

### POST /account/catalog_services

Source: https://everii-group.github.io/mocoapp-api-docs/sections/account/catalog_services.html

Creates a catalog service including its items. The request body includes a title and an array of items with type, title, net_total, and optionally quantity, unit, and unit_price.

```bash
curl -X POST \
  'https://{domain}.mocoapp.com/api/v1/account/catalog_services' \
  -H 'Authorization: Token token=YOUR_API_KEY'
  -H 'Content-Type: application/json' \
  -d '{
        "title": "Catalog entry",
        "items": [
          {
            "type": "item",
            "title": "Setup",
            "net_total": 1200.0
          },
          {
            "type": "item",
            "title": "Consulting",
            "quantity": 20.0,
            "unit": "h",
            "unit_price": 150.0,
            "net_total": 3000.0
          }
        ]
      }'

```
Tokens:
Raw