- Clio takes the availability and stability of our API seriously; please report any degradations or breakages to Clio's API Support team at api@clio.com.
- For business and partnership inquiries, contact our API Partnerships team at api.partnerships@clio.com.
- For best practices and tips from the Clio development community, join the conversation in the Clio Developer Slack Channel.
A community-driven Clio Developers Stack Overflow Group also exists where you can connect and ask questions from other Clio API users.
Note: The API is available in four distinct data regions: Australia (au.app.clio.com), Canada (ca.app.clio.com), EU (eu.app.clio.com) and US (app.clio.com).
Likewise, the developer portal is available at region-specific links for the Australia, Canada, EU, and US regions.
This document assumes the US region is being used (app.clio.com). If you're building in one of the other regions, you should adapt the links and examples as necessary.
To start building on the Clio API, you’ll need a Clio account – you can review our Developer Handbook and follow the steps to sign up for an account.
Once you have an account, you can create a developer application from the Developer Portal and start building!
See our Authorization documentation →
See our Permissions documentation →
See our Fields documentation →
See our Rate Limits documentation →
See our Pagination documentation →
See our ETags documentation →
API v4 supports multiple minor versions. Versions are of the form '4.X.Y'. To request a specific version, you can use an X-API-VERSION
header in your request, with the header value set to the API version you're requesting. If this header is omitted, it will be treated as a request for the default API version. If the header is present but invalid, it will return a 410 Gone
response. If the header is present and valid, but it is no longer supported, it will return a 410 Gone
response.
An X-API-VERSION
will be included in all successful responses, with the value being set to the API version used.
You can find our API Versioning Policy and Guidelines in our documentation hub.
The API Changelog explains each version's changes in further detail.
4.0.4
Update
quantity
field to return values in seconds rather than hours for Activities4.0.5
- Remove
matter_balances
field from Bills - Standardize status/state enum values
- Add a Document association to completed DocumentAutomations
- Add rate visibility handling for Activity's price and total
- Remove
4.0.6
Remove
document_versions
collection field from Documents4.0.7
Change secure link format
4.0.8
Activity
hours are redacted in the response based on the activity hours visibility setting for the user- Add
quantity_redacted
field to activities
4.0.9
This is the default version
Contacts are filtered and redacted in the response based on the new 'Contacts Visibility' user permission setting.
4.0.10
Fixed validation of
type
query parameter when querying Notes
In Clio, applications can create custom actions in our interface. Links are unique across an application, user, location in the UI (ui_reference
) and label. When the user clicks on a custom action, Clio will open a new browser tab at the target_url
.
Clio will add a few URL parameters to the target_url
, including the custom action ID, the ID of the user who clicked the link and the URL of the object(s) which the link was clicked on. The third party application must then look up the relevant OAuth token associated with the user and custom action, and make an authenticated request to the subject_url
. This request both lets you validate the request was made by who you expected, that they have access to the record and lets you pull down any extra information you may need.
Currently supported for: Activities, Contacts, Documents and Matters
Confirming a User's Action
As custom actions require an unauthorized GET request, which can be faked, Clio has provided a way to validate that a user has actually performed an action.
When a request is sent to the URL specified on the custom action, we will include a custom_action_nonce
parameter. If you send us back the custom_action_nonce
in your next request to the API, Clio will use it to validate that the user who clicked the custom action matches your oauth token request. If no match is made, an error will be returned.
Return the data for all CustomActions
Outlines the parameters, optional and required, used when requesting the data for all CustomActions
query Parameters
created_since | string <date-time> Filter CustomAction records to those having the |
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
ids[] | integer <int64> Filter CustomAction records to those having the specified unique identifiers. |
limit | integer <int32> A limit on the number of CustomAction records to be returned. Limit can range between 1 and 200. Default: |
page_token | string A token specifying which page to return. |
updated_since | string <date-time> Filter CustomAction records to those having the |
header Parameters
X-API-VERSION | string The API minor version. Default: latest version. |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": [
- {
- "id": 0,
- "etag": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "label": "string",
- "target_url": "string",
- "ui_reference": "activities/show"
}
]
}
Create a new CustomAction
Outlines the parameters and data fields used when creating a new CustomAction
query Parameters
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
header Parameters
X-API-VERSION | string The API minor version. Default: latest version. |
Request Body schema: optional
Request Body for Custom Actions
required | object | ||||||
|
Responses
Request samples
- Payload
{- "data": {
- "label": "string",
- "target_url": "string",
- "ui_reference": "activities/show"
}
}
Response samples
- 201
- 400
- 401
- 403
- 404
- 422
- 429
{- "data": {
- "id": 0,
- "etag": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "label": "string",
- "target_url": "string",
- "ui_reference": "activities/show"
}
}
Return the data for a single CustomAction
Outlines the parameters, optional and required, used when requesting the data for a single CustomAction
path Parameters
id required | integer <int64> The unique identifier for the CustomAction. |
query Parameters
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
header Parameters
IF-MODIFIED-SINCE | string <date> The server will send the requested resource with a 200 status, but only if it has been modified after the given date. (Expects an RFC 2822 timestamp). |
IF-NONE-MATCH | string The server will send the requested resource with a 200 status, but only if the existing resource's ETag doesn't match any of the values listed. |
X-API-VERSION | string The API minor version. Default: latest version. |
Responses
Response samples
- 200
- 400
- 401
- 403
- 404
- 429
{- "data": {
- "id": 0,
- "etag": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "label": "string",
- "target_url": "string",
- "ui_reference": "activities/show"
}
}
Update a single CustomAction
Outlines the parameters and data fields used when updating a single CustomAction
path Parameters
id required | integer <int64> The unique identifier for the CustomAction. |
query Parameters
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
header Parameters
IF-MATCH | string The server will update the requested resource and send back a 200 status, but only if value in the header matches the existing resource's ETag. |
X-API-VERSION | string The API minor version. Default: latest version. |
Request Body schema: optional
Request Body for Custom Actions
required | object | ||||||
|
Responses
Request samples
- Payload
{- "data": {
- "label": "string",
- "target_url": "string",
- "ui_reference": "activities/show"
}
}
Response samples
- 200
- 400
- 401
- 403
- 404
- 412
- 422
- 429
{- "data": {
- "id": 0,
- "etag": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "label": "string",
- "target_url": "string",
- "ui_reference": "activities/show"
}
}
Delete a single CustomAction
Outlines the parameters, optional and required, used when deleting the record for a single CustomAction
path Parameters
id required | integer <int64> The unique identifier for the CustomAction. |
header Parameters
X-API-VERSION | string The API minor version. Default: latest version. |
Responses
Response samples
- 403
{- "error": {
- "type": "string",
- "message": "string"
}
}
Webhooks are a way of detecting events in Clio without the need for polling.
A webhook can be subscribed to a number of events
on a model. Some events will be different depending on the chosen model, but (with one exception) all models support the following events:
created
updated
deleted
To subscribe to any or all events for a model, create a webhook record with the URL that you want webhooks to be sent to, a model, and the list of events
you care about. Whenever an event happens on that model in Clio that the user is authorized to see, an HTTP request will be made to the supplied URL with details about the event. A webhook will automatically expire after a set period of time. If no expires_at
parameter is provided, the webhook will expire after 3 days. The maximum duration you can set a webhook to expire after is 31 days. If you require longer than that, you can manually extend it by updating the expires_at
field.
Your application needs to have the corresponding model OAuth scope when creating or updating a webhook. For example, when creating/updating a folder webhook you need the document Oauth Scope and the webhook Oauth Scope. The list of models supported by webhooks with their corresponding string identifier and ID is presented in the following table:
Name | String Identifier | ID | Oauth Scope |
---|---|---|---|
Matter | matter | 1 | Matters |
Activity | activity | 2 | Activities |
Bill | bill | 3 | Billing |
Calendar Entry | calendar_entry | 4 | Calendars |
Communication | communication | 5 | Communications |
Contact | contact | 6 | Contacts |
Task | task | 7 | Tasks |
Document | document | 8 | Documents |
Folder | folder | 9 | Documents |
Clio Payments payment | clio_payments_payment | 10 | Clio Payments |
Please note that all webhooks MUST be using a url with the https
scheme. All other schemes, including http
, will be rejected.
When a webhook is sent, the payload will not include the entire object for the record. To select specific fields from the record, you can use the fields parameter when creating the webhook. For example: when creating a webhook listening for new Activity records being created, you can pass the value “id,etag,quantity,price” into the fields parameter. When an Activity is created, the id, etag, quantity, and price fields of the new Activity will be included in the webhook's payload.
For update
webhooks, the fields parameter is also used to specify fields that will be “watched” by the webhook. Clio will only send a webhook when at least one of the selected fields has changed on a record.
An important note If you have never received a webhook for an object before, you will receive a webhook for that object if any fields have changed on that object, including fields you haven't subscribed to. For example: if you create a webhook that subscribes to updates to Activities and provide "price" as the field parameter value, the first time an Activity is updated after the Webhook is live will trigger a webhook event – even if the price hasn't changed. Subsequent webhook events for that Activity will only be sent when the price field changes.
Note that there is a hard limit to the size of the fields
parameter. Any request containing a fields
size over 1000 characters will be rejected.
Tip: Use the minimum set of fields to reduce how frequently your endpoint is hit.
As mentioned previously, almost all models support the created, updated, and deleted events. Some models also support events specific to their life cycle.
Clio Payments payments
created
is fired whenever a payment is createdupdated
is fired whenever a payment is updated
All other Models
created
is fired whenever a model is createdupdated
is fired whenever a model is updateddeleted
is fired whenever a model is deleted
Matters
matter_opened
is fired whenever a matter's status changes to "Open"matter_pended
is fired whenever a matter's status changes to "Pending"matter_closed
is fired whenever a matter's status changes to "Close"
More model-specific events will be coming soon.
A response status code of 2xx
, 3xx
, or 410 GONE
indicate that the action was successfully processed. When a 410 GONE
response is received, the webhook subscription will be disabled. All other responses will be considered unsuccessful, and they will be retried using an exponential backoff strategy.
Timeouts
Clio will wait a short period of time before the request will timeout. We will consider it an unsuccessful response and retry using an exponential backoff strategy. It is important to respond quickly. Failure to do so repeatedly may result in your webhook being disabled. If you need to do lengthy processing with the webhook, it is recommended that you defer the processing until after you have sent a response back to Clio.
Identity Confirmation
To ensure that a URL actually intends to receive webhooks from Clio, and to ensure that the payloads are actually from Clio, we will share a secret in the initial handshake.
A POST request will be made immediately after a webhook is setup, or whenever the URL changes. This request will have a unique secret in a X-Hook-Secret
header along with the id of the webhook that was just created. There are two ways of confirming the webhook using this secret:
Option 1: Immediate
Upon initially receiving this secret, the endpoint can return a 200 OK
response and include the same secret in a X-Hook-Secret
header.
Option 2: Delayed
After receiving the secret, make a PUT request to /api/v4/webhooks/:webhook_id/activate
with the secret in a X-Hook-Secret
header.
Note that a webhook will not be enabled until this handshake is successful.
Confirming Hook Legitimacy
To prove that Clio is sending all subsequent messages, Clio will sign all of the requests.
Clio will compute an HMAC-SHA256 signature based on the shared secret and the request body. That signature will then be placed in a X-Hook-Signature
header. The endpoint can then verify the signature to know if the message is authentic. Verification is as simple as computing an HMAC-SHA256 signature using the shared secret as the key and the request body as the message, and comparing it to the X-Hook-Signature
header.
A Webhook can be created for the Activities model, to trigger on any events and return the id and etag fields:
{
"data":{
"url":"https://my/callback/url",
"fields":"id,etag",
"model":"activity",
"events":["created","deleted","updated"]
}
}
This webhook would have the following responses for different actions. It would trigger on any events for the model, and return the id and etag fields for that model, and the event type.
Notes:
- The
model
field accepts both the string identifier of the model as in the example, or its ID. In the latter case, you would have provided the ID parameter:"model":2
. Refer to the table listing the models supported by webhooks for matching the model name with its ID.
Create
In the event of an Activity being created, your URL would receive the following JSON:
{
"data":{
"id":152,
"etag":"\"9a103be2201ae758992733a91f02903f\""
},
"meta":{
"event":"created",
"webhook_id":1234
}
}
Update
In the event of an Activity being updated, your URL would receive the following JSON:
{
"data":{
"id":152,
"etag":"\"9d9ef9fb42a505976d90d564c1596f11\""
},
"meta":{
"event":"updated",
"webhook_id":1234
}
}
Delete
In the event of an Activity being deleted, your URL would receive the following JSON:
{
"data":{
"id":152,
"etag":"\"3cc31bfbd6cfc16d3d7123423e437079\""
},
"meta":{
"event":"deleted",
"webhook_id":1234
}
}
Return the data for all Webhooks
Outlines the parameters, optional and required, used when requesting the data for all Webhooks
query Parameters
created_since | string <date-time> Filter Webhook records to those having the |
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
ids[] | integer <int64> Filter Webhook records to those having the specified unique identifiers. |
limit | integer <int32> A limit on the number of Webhook records to be returned. Limit can range between 1 and 200. Default: |
order | string Enum: "id(asc)" "id(desc)" Orders the Webhook records by the given field. Default: |
page_token | string A token specifying which page to return. |
updated_since | string <date-time> Filter Webhook records to those having the |
header Parameters
X-API-VERSION | string The API minor version. Default: latest version. |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": [
- {
- "id": 0,
- "etag": "string",
- "url": "string",
- "fields": "string",
- "shared_secret": "string",
- "model": "activity",
- "status": "pending",
- "events": [
- "created"
], - "expires_at": "2019-08-24T14:15:22Z",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "user": {
- "account_owner": true,
- "clio_connect": true,
- "court_rules_default_attendee": true,
- "created_at": "2019-08-24T14:15:22Z",
- "default_calendar_id": 0,
- "email": "string",
- "enabled": true,
- "etag": "string",
- "first_name": "string",
- "id": 0,
- "initials": "string",
- "last_name": "string",
- "name": "string",
- "phone_number": "string",
- "rate": 0.1,
- "roles": [
- "string"
], - "subscription_type": "Attorney",
- "time_zone": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
]
}
Create a new Webhook
Outlines the parameters and data fields used when creating a new Webhook
query Parameters
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
header Parameters
X-API-VERSION | string The API minor version. Default: latest version. |
Request Body schema: optional
Request Body for Webhooks
required | object | ||||||||||
|
Responses
Request samples
- Payload
{- "data": {
- "events": [
- "created"
], - "expires_at": "2019-08-24T14:15:22Z",
- "fields": "string",
- "model": "activity",
- "url": "string"
}
}
Response samples
- 201
- 400
- 401
- 403
- 404
- 422
- 429
{- "data": {
- "id": 0,
- "etag": "string",
- "url": "string",
- "fields": "string",
- "shared_secret": "string",
- "model": "activity",
- "status": "pending",
- "events": [
- "created"
], - "expires_at": "2019-08-24T14:15:22Z",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "user": {
- "account_owner": true,
- "clio_connect": true,
- "court_rules_default_attendee": true,
- "created_at": "2019-08-24T14:15:22Z",
- "default_calendar_id": 0,
- "email": "string",
- "enabled": true,
- "etag": "string",
- "first_name": "string",
- "id": 0,
- "initials": "string",
- "last_name": "string",
- "name": "string",
- "phone_number": "string",
- "rate": 0.1,
- "roles": [
- "string"
], - "subscription_type": "Attorney",
- "time_zone": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
}
Return the data for a single Webhook
Outlines the parameters, optional and required, used when requesting the data for a single Webhook
path Parameters
id required | integer <int64> The unique identifier for the Webhook. |
query Parameters
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
header Parameters
IF-MODIFIED-SINCE | string <date> The server will send the requested resource with a 200 status, but only if it has been modified after the given date. (Expects an RFC 2822 timestamp). |
IF-NONE-MATCH | string The server will send the requested resource with a 200 status, but only if the existing resource's ETag doesn't match any of the values listed. |
X-API-VERSION | string The API minor version. Default: latest version. |
Responses
Response samples
- 200
- 400
- 401
- 403
- 404
- 429
{- "data": {
- "id": 0,
- "etag": "string",
- "url": "string",
- "fields": "string",
- "shared_secret": "string",
- "model": "activity",
- "status": "pending",
- "events": [
- "created"
], - "expires_at": "2019-08-24T14:15:22Z",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "user": {
- "account_owner": true,
- "clio_connect": true,
- "court_rules_default_attendee": true,
- "created_at": "2019-08-24T14:15:22Z",
- "default_calendar_id": 0,
- "email": "string",
- "enabled": true,
- "etag": "string",
- "first_name": "string",
- "id": 0,
- "initials": "string",
- "last_name": "string",
- "name": "string",
- "phone_number": "string",
- "rate": 0.1,
- "roles": [
- "string"
], - "subscription_type": "Attorney",
- "time_zone": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
}
Update a single Webhook
Outlines the parameters and data fields used when updating a single Webhook
path Parameters
id required | integer <int64> The unique identifier for the Webhook. |
query Parameters
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
header Parameters
IF-MATCH | string The server will update the requested resource and send back a 200 status, but only if value in the header matches the existing resource's ETag. |
X-API-VERSION | string The API minor version. Default: latest version. |
Request Body schema: optional
Request Body for Webhooks
required | object | ||||||||||
|
Responses
Request samples
- Payload
{- "data": {
- "events": [
- "created"
], - "expires_at": "2019-08-24T14:15:22Z",
- "fields": "string",
- "model": "activity",
- "url": "string"
}
}
Response samples
- 200
- 400
- 401
- 403
- 404
- 412
- 422
- 429
{- "data": {
- "id": 0,
- "etag": "string",
- "url": "string",
- "fields": "string",
- "shared_secret": "string",
- "model": "activity",
- "status": "pending",
- "events": [
- "created"
], - "expires_at": "2019-08-24T14:15:22Z",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "user": {
- "account_owner": true,
- "clio_connect": true,
- "court_rules_default_attendee": true,
- "created_at": "2019-08-24T14:15:22Z",
- "default_calendar_id": 0,
- "email": "string",
- "enabled": true,
- "etag": "string",
- "first_name": "string",
- "id": 0,
- "initials": "string",
- "last_name": "string",
- "name": "string",
- "phone_number": "string",
- "rate": 0.1,
- "roles": [
- "string"
], - "subscription_type": "Attorney",
- "time_zone": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
}
Delete a single Webhook
Outlines the parameters, optional and required, used when deleting the record for a single Webhook
path Parameters
id required | integer <int64> The unique identifier for the Webhook. |
header Parameters
X-API-VERSION | string The API minor version. Default: latest version. |
Responses
Response samples
- 403
{- "error": {
- "type": "string",
- "message": "string"
}
}
Activities (Time Entries and Expense Entries) track work done at a firm. Activities are recorded in Clio and then posted on bills to clients.
Time Entries can be either be hourly-billable or flat-rate. An hourly-billable Time Entry is valued at the billing rate multiplied by the time entered. Examples could be a phone call, or a research session. A flat-rate Time Entry has a set value. Examples could be a visa application, or a contract review.
Expenses are reimbursable costs the firm pays on behalf of a client (for example, postage, copy fees, etc.).
Return the data for all Activities
Outlines the parameters, optional and required, used when requesting the data for all Activities
query Parameters
activity_description_id | integer <int64> The unique identifier for a single ActivityDescription. Use the keyword |
calendar_entry_id | integer <int64> The unique identifier for a single CalendarEntry. Use the keyword |
communication_id | integer <int64> The unique identifier for a single Communication. Use the keyword |
contact_note_id | integer <int64> The unique identifier for a single Note. Use the keyword |
created_since | string <date-time> Filter Activity records to those having the |
end_date | string <date-time> Filter Activity records to those whose |
expense_category_id | integer <int64> The unique identifier for a single ExpenseCategory. Use the keyword |
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
flat_rate | boolean Filter Activity TimeEntry records to those that have a flat rate, or not. |
grant_id | integer <int64> The unique identifier for a single Grant. Use the keyword |
ids[] | integer <int64> Filter Activity records to those having the specified unique identifiers. |
limit | integer <int32> A limit on the number of Activity records to be returned. Limit can range between 1 and 200. Default: |
matter_id | integer <int64> The unique identifier for a single Matter. Use the keyword |
matter_note_id | integer <int64> The unique identifier for a single Note. Use the keyword |
only_unaccounted_for | boolean Only unaccounted for activities. |
order | string Enum: "id(asc)" "id(desc)" "display_number(asc)" "display_number(desc)" "user.name(asc)" "user.name(desc)" "price(asc)" "price(desc)" "total(asc)" "total(desc)" "type(asc)" "type(desc)" "date(asc)" "date(desc)" "note(asc)" "note(desc)" "updated_at(asc)" "updated_at(desc)" "vendor.name(asc)" "vendor.name(desc)" "expense_category.name(asc)" "expense_category.name(desc)" "non_billable(asc)" "non_billable(desc)" "non_billable_total(asc)" "non_billable_total(desc)" Orders the Activity records by the given field. Default: |
page_token | string A token specifying which page to return. |
query | string Wildcard search for |
start_date | string <date-time> Filter Activity records to those whose |
status | string Enum: "billed" "draft" "unbilled" "non_billable" "billable" "written_off" Filter Activity records to those that are draft, billed, unbilled or non-billable. |
task_id | integer <int64> The unique identifier for a single Task. Use the keyword |
type | string Enum: "TimeEntry" "ExpenseEntry" "HardCostEntry" "SoftCostEntry" Filter Activity records to those of a specific type. |
updated_since | string <date-time> Filter Activity records to those having the |
user_id | integer <int64> The unique identifier for a single User. Use the keyword |
header Parameters
X-API-VERSION | string The API minor version. Default: latest version. |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": [
- {
- "id": 0,
- "etag": "string",
- "type": "TimeEntry",
- "date": "2019-08-24",
- "quantity_in_hours": 0.1,
- "rounded_quantity_in_hours": 0.1,
- "quantity": 0.1,
- "rounded_quantity": 0.1,
- "quantity_redacted": true,
- "price": 0.1,
- "note": "string",
- "flat_rate": true,
- "billed": true,
- "on_bill": true,
- "total": 0.1,
- "contingency_fee": true,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "reference": "string",
- "non_billable": true,
- "non_billable_total": 0.1,
- "no_charge": true,
- "tax_setting": "no_tax",
- "activity_description": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "visible_to_co_counsel": true,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "default": true,
- "type": "string",
- "utbms_activity_id": 0,
- "utbms_task_name": "string",
- "utbms_task_id": 0,
- "xero_service_code": "string",
- "accessible_to_user": true,
- "category_type": "string"
}, - "expense_category": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "rate": 0,
- "entry_type": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "xero_expense_code": "string",
- "accessible_to_user": true,
- "tax_setting": "string"
}, - "bill": {
- "id": 0,
- "etag": "string",
- "number": "string",
- "issued_at": "2019-08-24",
- "created_at": "2019-08-24T14:15:22Z",
- "due_at": "2019-08-24",
- "tax_rate": 0.1,
- "secondary_tax_rate": 0.1,
- "updated_at": "2019-08-24T14:15:22Z",
- "subject": "string",
- "purchase_order": "string",
- "type": "MatterBill",
- "memo": "string",
- "start_at": "2019-08-24",
- "end_at": "2019-08-24",
- "balance": 0.1,
- "state": "draft",
- "kind": "revenue_kind",
- "total": 0.1,
- "paid": 0.1,
- "paid_at": "2019-08-24T14:15:22Z",
- "pending": 0.1,
- "due": 0.1,
- "discount_services_only": "string",
- "can_update": true,
- "credits_issued": 0.1,
- "shared": true,
- "last_sent_at": "2019-08-24T14:15:22Z",
- "services_secondary_tax": 0.1,
- "services_sub_total": 0.1,
- "services_tax": 0.1,
- "services_taxable_sub_total": 0,
- "services_secondary_taxable_sub_total": 0,
- "taxable_sub_total": 0,
- "secondary_taxable_sub_total": 0,
- "sub_total": 0.1,
- "tax_sum": 0.1,
- "secondary_tax_sum": 0.1,
- "total_tax": 0.1,
- "available_state_transitions": "awaiting_approval"
}, - "communication": {
- "id": 0,
- "etag": "string",
- "subject": "string",
- "body": "string",
- "type": "EmailCommunication",
- "date": "2019-08-24",
- "time_entries_count": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "received_at": "2019-08-24T14:15:22Z"
}, - "client_portal": {
- "id": 0,
- "etag": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "unread_count": 0,
- "unread_notifiable_count": 0
}, - "matter": {
- "id": 0,
- "etag": "string",
- "number": 0,
- "display_number": "string",
- "custom_number": "string",
- "description": "string",
- "status": "Pending",
- "location": "string",
- "client_reference": "string",
- "client_id": 0,
- "billable": true,
- "maildrop_address": "string",
- "billing_method": "flat",
- "open_date": "2019-08-24",
- "close_date": "2019-08-24",
- "pending_date": "2019-08-24",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "shared": true,
- "has_tasks": true,
- "last_activity_date": "2019-08-24",
- "matter_stage_updated_at": "2019-08-24T14:15:22Z"
}, - "matter_note": {
- "id": 0,
- "etag": "string",
- "type": "Matter",
- "subject": "string",
- "detail": "string",
- "date": "2019-08-24",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "time_entries_count": 0
}, - "contact_note": {
- "id": 0,
- "etag": "string",
- "type": "Matter",
- "subject": "string",
- "detail": "string",
- "date": "2019-08-24",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "time_entries_count": 0
}, - "subject": {
- "id": 0,
- "type": "Task",
- "identifier": "string",
- "secondary_identifier": "string",
- "tertiary_identifier": "string"
}, - "timer": {
- "id": 0,
- "etag": "string",
- "start_time": "2019-08-24T14:15:22Z",
- "elapsed_time": 0.1,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "user": {
- "account_owner": true,
- "clio_connect": true,
- "court_rules_default_attendee": true,
- "created_at": "2019-08-24T14:15:22Z",
- "default_calendar_id": 0,
- "email": "string",
- "enabled": true,
- "etag": "string",
- "first_name": "string",
- "id": 0,
- "initials": "string",
- "last_name": "string",
- "name": "string",
- "phone_number": "string",
- "rate": 0.1,
- "roles": [
- "string"
], - "subscription_type": "Attorney",
- "time_zone": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "utbms_expense": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "code": "string",
- "description": "string",
- "type": "UtbmsTask",
- "utbms_set_id": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "vendor": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "first_name": "string",
- "middle_name": "string",
- "last_name": "string",
- "date_of_birth": "2019-08-24",
- "type": "Company",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "prefix": "string",
- "title": "string",
- "initials": "string",
- "clio_connect_email": "string",
- "locked_clio_connect_email": true,
- "client_connect_user_id": 0,
- "primary_email_address": "string",
- "secondary_email_address": "string",
- "primary_phone_number": "string",
- "secondary_phone_number": "string",
- "ledes_client_id": "string",
- "has_clio_for_clients_permission": true,
- "is_client": true,
- "is_clio_for_client_user": true,
- "is_co_counsel": true,
- "is_bill_recipient": true,
- "sales_tax_number": "string"
}, - "calendar_entry": {
- "id": "string",
- "etag": "string",
- "calendar_owner_id": 0
}, - "task": {
- "id": 0,
- "etag": "string"
}, - "text_message_conversation": {
- "id": 0,
- "etag": "string"
}, - "document_version": {
- "id": 0,
- "document_id": 0,
- "etag": "string",
- "uuid": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "filename": "string",
- "size": 0,
- "version_number": 0,
- "content_type": "string",
- "received_at": "2019-08-24T14:15:22Z",
- "put_url": "string",
- "fully_uploaded": true
}, - "legal_aid_uk_activity": {
- "activity_sub_category": "string",
- "advocacy": 0,
- "base_rate": 0.1,
- "bolt_ons": "string",
- "court": 0,
- "eligible_for_sqm": true,
- "expert": 0,
- "form_of_civil_legal_service": 0,
- "id": 0,
- "is_custom_rate": true,
- "json_key": "string",
- "region": 0,
- "tax_exclusive": true,
- "uplift": 0.1,
- "user_type": 0
}
}
]
}
Create a new Activity
Outlines the parameters and data fields used when creating a new Activity
query Parameters
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
header Parameters
X-API-VERSION | string The API minor version. Default: latest version. |
Request Body schema: optional
Request Body for Activities
required | object | ||||||||||||||||||||||||||||||||||||||||||||||
|
Responses
Request samples
- Payload
{- "data": {
- "activity_description": {
- "id": 0,
- "utbms_task_id": 0,
- "utbms_activity_id": 0
}, - "calendar_entry": {
- "id": 0
}, - "client_portal": {
- "id": 0
}, - "communication": {
- "id": 0
}, - "contact_note": {
- "id": 0
}, - "date": "2019-08-24",
- "expense_category": {
- "id": 0
}, - "matter": {
- "id": 0
}, - "matter_note": {
- "id": 0
}, - "no_charge": true,
- "non_billable": true,
- "note": "string",
- "price": 0.1,
- "quantity": 0.1,
- "reference": "string",
- "start_timer": true,
- "task": {
- "id": 0
}, - "tax_setting": "no_tax",
- "text_message_conversation": {
- "id": 0
}, - "type": "TimeEntry",
- "user": {
- "id": 0
}, - "utbms_expense": {
- "id": 0
}, - "vendor": {
- "id": 0
}
}
}
Response samples
- 201
- 400
- 401
- 403
- 404
- 422
- 429
{- "data": {
- "id": 0,
- "etag": "string",
- "type": "TimeEntry",
- "date": "2019-08-24",
- "quantity_in_hours": 0.1,
- "rounded_quantity_in_hours": 0.1,
- "quantity": 0.1,
- "rounded_quantity": 0.1,
- "quantity_redacted": true,
- "price": 0.1,
- "note": "string",
- "flat_rate": true,
- "billed": true,
- "on_bill": true,
- "total": 0.1,
- "contingency_fee": true,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "reference": "string",
- "non_billable": true,
- "non_billable_total": 0.1,
- "no_charge": true,
- "tax_setting": "no_tax",
- "activity_description": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "visible_to_co_counsel": true,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "default": true,
- "type": "string",
- "utbms_activity_id": 0,
- "utbms_task_name": "string",
- "utbms_task_id": 0,
- "xero_service_code": "string",
- "accessible_to_user": true,
- "category_type": "string"
}, - "expense_category": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "rate": 0,
- "entry_type": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "xero_expense_code": "string",
- "accessible_to_user": true,
- "tax_setting": "string"
}, - "bill": {
- "id": 0,
- "etag": "string",
- "number": "string",
- "issued_at": "2019-08-24",
- "created_at": "2019-08-24T14:15:22Z",
- "due_at": "2019-08-24",
- "tax_rate": 0.1,
- "secondary_tax_rate": 0.1,
- "updated_at": "2019-08-24T14:15:22Z",
- "subject": "string",
- "purchase_order": "string",
- "type": "MatterBill",
- "memo": "string",
- "start_at": "2019-08-24",
- "end_at": "2019-08-24",
- "balance": 0.1,
- "state": "draft",
- "kind": "revenue_kind",
- "total": 0.1,
- "paid": 0.1,
- "paid_at": "2019-08-24T14:15:22Z",
- "pending": 0.1,
- "due": 0.1,
- "discount_services_only": "string",
- "can_update": true,
- "credits_issued": 0.1,
- "shared": true,
- "last_sent_at": "2019-08-24T14:15:22Z",
- "services_secondary_tax": 0.1,
- "services_sub_total": 0.1,
- "services_tax": 0.1,
- "services_taxable_sub_total": 0,
- "services_secondary_taxable_sub_total": 0,
- "taxable_sub_total": 0,
- "secondary_taxable_sub_total": 0,
- "sub_total": 0.1,
- "tax_sum": 0.1,
- "secondary_tax_sum": 0.1,
- "total_tax": 0.1,
- "available_state_transitions": "awaiting_approval"
}, - "communication": {
- "id": 0,
- "etag": "string",
- "subject": "string",
- "body": "string",
- "type": "EmailCommunication",
- "date": "2019-08-24",
- "time_entries_count": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "received_at": "2019-08-24T14:15:22Z"
}, - "client_portal": {
- "id": 0,
- "etag": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "unread_count": 0,
- "unread_notifiable_count": 0
}, - "matter": {
- "id": 0,
- "etag": "string",
- "number": 0,
- "display_number": "string",
- "custom_number": "string",
- "description": "string",
- "status": "Pending",
- "location": "string",
- "client_reference": "string",
- "client_id": 0,
- "billable": true,
- "maildrop_address": "string",
- "billing_method": "flat",
- "open_date": "2019-08-24",
- "close_date": "2019-08-24",
- "pending_date": "2019-08-24",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "shared": true,
- "has_tasks": true,
- "last_activity_date": "2019-08-24",
- "matter_stage_updated_at": "2019-08-24T14:15:22Z"
}, - "matter_note": {
- "id": 0,
- "etag": "string",
- "type": "Matter",
- "subject": "string",
- "detail": "string",
- "date": "2019-08-24",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "time_entries_count": 0
}, - "contact_note": {
- "id": 0,
- "etag": "string",
- "type": "Matter",
- "subject": "string",
- "detail": "string",
- "date": "2019-08-24",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "time_entries_count": 0
}, - "subject": {
- "id": 0,
- "type": "Task",
- "identifier": "string",
- "secondary_identifier": "string",
- "tertiary_identifier": "string"
}, - "timer": {
- "id": 0,
- "etag": "string",
- "start_time": "2019-08-24T14:15:22Z",
- "elapsed_time": 0.1,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "user": {
- "account_owner": true,
- "clio_connect": true,
- "court_rules_default_attendee": true,
- "created_at": "2019-08-24T14:15:22Z",
- "default_calendar_id": 0,
- "email": "string",
- "enabled": true,
- "etag": "string",
- "first_name": "string",
- "id": 0,
- "initials": "string",
- "last_name": "string",
- "name": "string",
- "phone_number": "string",
- "rate": 0.1,
- "roles": [
- "string"
], - "subscription_type": "Attorney",
- "time_zone": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "utbms_expense": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "code": "string",
- "description": "string",
- "type": "UtbmsTask",
- "utbms_set_id": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "vendor": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "first_name": "string",
- "middle_name": "string",
- "last_name": "string",
- "date_of_birth": "2019-08-24",
- "type": "Company",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "prefix": "string",
- "title": "string",
- "initials": "string",
- "clio_connect_email": "string",
- "locked_clio_connect_email": true,
- "client_connect_user_id": 0,
- "primary_email_address": "string",
- "secondary_email_address": "string",
- "primary_phone_number": "string",
- "secondary_phone_number": "string",
- "ledes_client_id": "string",
- "has_clio_for_clients_permission": true,
- "is_client": true,
- "is_clio_for_client_user": true,
- "is_co_counsel": true,
- "is_bill_recipient": true,
- "sales_tax_number": "string"
}, - "calendar_entry": {
- "id": "string",
- "etag": "string",
- "calendar_owner_id": 0
}, - "task": {
- "id": 0,
- "etag": "string"
}, - "text_message_conversation": {
- "id": 0,
- "etag": "string"
}, - "document_version": {
- "id": 0,
- "document_id": 0,
- "etag": "string",
- "uuid": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "filename": "string",
- "size": 0,
- "version_number": 0,
- "content_type": "string",
- "received_at": "2019-08-24T14:15:22Z",
- "put_url": "string",
- "fully_uploaded": true
}, - "legal_aid_uk_activity": {
- "activity_sub_category": "string",
- "advocacy": 0,
- "base_rate": 0.1,
- "bolt_ons": "string",
- "court": 0,
- "eligible_for_sqm": true,
- "expert": 0,
- "form_of_civil_legal_service": 0,
- "id": 0,
- "is_custom_rate": true,
- "json_key": "string",
- "region": 0,
- "tax_exclusive": true,
- "uplift": 0.1,
- "user_type": 0
}
}
}
Return the data for a single Activity
Outlines the parameters, optional and required, used when requesting the data for a single Activity
path Parameters
id required | integer <int64> The unique identifier for the Activity. |
query Parameters
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
header Parameters
IF-MODIFIED-SINCE | string <date> The server will send the requested resource with a 200 status, but only if it has been modified after the given date. (Expects an RFC 2822 timestamp). |
IF-NONE-MATCH | string The server will send the requested resource with a 200 status, but only if the existing resource's ETag doesn't match any of the values listed. |
X-API-VERSION | string The API minor version. Default: latest version. |
Responses
Response samples
- 200
- 400
- 401
- 403
- 404
- 429
{- "data": {
- "id": 0,
- "etag": "string",
- "type": "TimeEntry",
- "date": "2019-08-24",
- "quantity_in_hours": 0.1,
- "rounded_quantity_in_hours": 0.1,
- "quantity": 0.1,
- "rounded_quantity": 0.1,
- "quantity_redacted": true,
- "price": 0.1,
- "note": "string",
- "flat_rate": true,
- "billed": true,
- "on_bill": true,
- "total": 0.1,
- "contingency_fee": true,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "reference": "string",
- "non_billable": true,
- "non_billable_total": 0.1,
- "no_charge": true,
- "tax_setting": "no_tax",
- "activity_description": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "visible_to_co_counsel": true,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "default": true,
- "type": "string",
- "utbms_activity_id": 0,
- "utbms_task_name": "string",
- "utbms_task_id": 0,
- "xero_service_code": "string",
- "accessible_to_user": true,
- "category_type": "string"
}, - "expense_category": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "rate": 0,
- "entry_type": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "xero_expense_code": "string",
- "accessible_to_user": true,
- "tax_setting": "string"
}, - "bill": {
- "id": 0,
- "etag": "string",
- "number": "string",
- "issued_at": "2019-08-24",
- "created_at": "2019-08-24T14:15:22Z",
- "due_at": "2019-08-24",
- "tax_rate": 0.1,
- "secondary_tax_rate": 0.1,
- "updated_at": "2019-08-24T14:15:22Z",
- "subject": "string",
- "purchase_order": "string",
- "type": "MatterBill",
- "memo": "string",
- "start_at": "2019-08-24",
- "end_at": "2019-08-24",
- "balance": 0.1,
- "state": "draft",
- "kind": "revenue_kind",
- "total": 0.1,
- "paid": 0.1,
- "paid_at": "2019-08-24T14:15:22Z",
- "pending": 0.1,
- "due": 0.1,
- "discount_services_only": "string",
- "can_update": true,
- "credits_issued": 0.1,
- "shared": true,
- "last_sent_at": "2019-08-24T14:15:22Z",
- "services_secondary_tax": 0.1,
- "services_sub_total": 0.1,
- "services_tax": 0.1,
- "services_taxable_sub_total": 0,
- "services_secondary_taxable_sub_total": 0,
- "taxable_sub_total": 0,
- "secondary_taxable_sub_total": 0,
- "sub_total": 0.1,
- "tax_sum": 0.1,
- "secondary_tax_sum": 0.1,
- "total_tax": 0.1,
- "available_state_transitions": "awaiting_approval"
}, - "communication": {
- "id": 0,
- "etag": "string",
- "subject": "string",
- "body": "string",
- "type": "EmailCommunication",
- "date": "2019-08-24",
- "time_entries_count": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "received_at": "2019-08-24T14:15:22Z"
}, - "client_portal": {
- "id": 0,
- "etag": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "unread_count": 0,
- "unread_notifiable_count": 0
}, - "matter": {
- "id": 0,
- "etag": "string",
- "number": 0,
- "display_number": "string",
- "custom_number": "string",
- "description": "string",
- "status": "Pending",
- "location": "string",
- "client_reference": "string",
- "client_id": 0,
- "billable": true,
- "maildrop_address": "string",
- "billing_method": "flat",
- "open_date": "2019-08-24",
- "close_date": "2019-08-24",
- "pending_date": "2019-08-24",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "shared": true,
- "has_tasks": true,
- "last_activity_date": "2019-08-24",
- "matter_stage_updated_at": "2019-08-24T14:15:22Z"
}, - "matter_note": {
- "id": 0,
- "etag": "string",
- "type": "Matter",
- "subject": "string",
- "detail": "string",
- "date": "2019-08-24",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "time_entries_count": 0
}, - "contact_note": {
- "id": 0,
- "etag": "string",
- "type": "Matter",
- "subject": "string",
- "detail": "string",
- "date": "2019-08-24",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "time_entries_count": 0
}, - "subject": {
- "id": 0,
- "type": "Task",
- "identifier": "string",
- "secondary_identifier": "string",
- "tertiary_identifier": "string"
}, - "timer": {
- "id": 0,
- "etag": "string",
- "start_time": "2019-08-24T14:15:22Z",
- "elapsed_time": 0.1,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "user": {
- "account_owner": true,
- "clio_connect": true,
- "court_rules_default_attendee": true,
- "created_at": "2019-08-24T14:15:22Z",
- "default_calendar_id": 0,
- "email": "string",
- "enabled": true,
- "etag": "string",
- "first_name": "string",
- "id": 0,
- "initials": "string",
- "last_name": "string",
- "name": "string",
- "phone_number": "string",
- "rate": 0.1,
- "roles": [
- "string"
], - "subscription_type": "Attorney",
- "time_zone": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "utbms_expense": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "code": "string",
- "description": "string",
- "type": "UtbmsTask",
- "utbms_set_id": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "vendor": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "first_name": "string",
- "middle_name": "string",
- "last_name": "string",
- "date_of_birth": "2019-08-24",
- "type": "Company",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "prefix": "string",
- "title": "string",
- "initials": "string",
- "clio_connect_email": "string",
- "locked_clio_connect_email": true,
- "client_connect_user_id": 0,
- "primary_email_address": "string",
- "secondary_email_address": "string",
- "primary_phone_number": "string",
- "secondary_phone_number": "string",
- "ledes_client_id": "string",
- "has_clio_for_clients_permission": true,
- "is_client": true,
- "is_clio_for_client_user": true,
- "is_co_counsel": true,
- "is_bill_recipient": true,
- "sales_tax_number": "string"
}, - "calendar_entry": {
- "id": "string",
- "etag": "string",
- "calendar_owner_id": 0
}, - "task": {
- "id": 0,
- "etag": "string"
}, - "text_message_conversation": {
- "id": 0,
- "etag": "string"
}, - "document_version": {
- "id": 0,
- "document_id": 0,
- "etag": "string",
- "uuid": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "filename": "string",
- "size": 0,
- "version_number": 0,
- "content_type": "string",
- "received_at": "2019-08-24T14:15:22Z",
- "put_url": "string",
- "fully_uploaded": true
}, - "legal_aid_uk_activity": {
- "activity_sub_category": "string",
- "advocacy": 0,
- "base_rate": 0.1,
- "bolt_ons": "string",
- "court": 0,
- "eligible_for_sqm": true,
- "expert": 0,
- "form_of_civil_legal_service": 0,
- "id": 0,
- "is_custom_rate": true,
- "json_key": "string",
- "region": 0,
- "tax_exclusive": true,
- "uplift": 0.1,
- "user_type": 0
}
}
}
Update a single Activity
Outlines the parameters and data fields used when updating a single Activity
path Parameters
id required | integer <int64> The unique identifier for the Activity. |
query Parameters
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
header Parameters
IF-MATCH | string The server will update the requested resource and send back a 200 status, but only if value in the header matches the existing resource's ETag. |
X-API-VERSION | string The API minor version. Default: latest version. |
Request Body schema: optional
Request Body for Activities
required | object | ||||||||||||||||||||||||||||||||||||||||||||||
|
Responses
Request samples
- Payload
{- "data": {
- "activity_description": {
- "id": 0,
- "utbms_task_id": 0,
- "utbms_activity_id": 0
}, - "calendar_entry": {
- "id": 0
}, - "client_portal": {
- "id": 0
}, - "communication": {
- "id": 0
}, - "contact_note": {
- "id": 0
}, - "date": "2019-08-24",
- "expense_category": {
- "id": 0
}, - "matter": {
- "id": 0
}, - "matter_note": {
- "id": 0
}, - "no_charge": true,
- "non_billable": true,
- "note": "string",
- "price": 0.1,
- "quantity": 0.1,
- "reference": "string",
- "start_timer": true,
- "task": {
- "id": 0
}, - "tax_setting": "no_tax",
- "text_message_conversation": {
- "id": 0
}, - "type": "TimeEntry",
- "user": {
- "id": 0
}, - "utbms_expense": {
- "id": 0
}, - "vendor": {
- "id": 0
}
}
}
Response samples
- 200
- 400
- 401
- 403
- 404
- 412
- 422
- 429
{- "data": {
- "id": 0,
- "etag": "string",
- "type": "TimeEntry",
- "date": "2019-08-24",
- "quantity_in_hours": 0.1,
- "rounded_quantity_in_hours": 0.1,
- "quantity": 0.1,
- "rounded_quantity": 0.1,
- "quantity_redacted": true,
- "price": 0.1,
- "note": "string",
- "flat_rate": true,
- "billed": true,
- "on_bill": true,
- "total": 0.1,
- "contingency_fee": true,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "reference": "string",
- "non_billable": true,
- "non_billable_total": 0.1,
- "no_charge": true,
- "tax_setting": "no_tax",
- "activity_description": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "visible_to_co_counsel": true,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "default": true,
- "type": "string",
- "utbms_activity_id": 0,
- "utbms_task_name": "string",
- "utbms_task_id": 0,
- "xero_service_code": "string",
- "accessible_to_user": true,
- "category_type": "string"
}, - "expense_category": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "rate": 0,
- "entry_type": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "xero_expense_code": "string",
- "accessible_to_user": true,
- "tax_setting": "string"
}, - "bill": {
- "id": 0,
- "etag": "string",
- "number": "string",
- "issued_at": "2019-08-24",
- "created_at": "2019-08-24T14:15:22Z",
- "due_at": "2019-08-24",
- "tax_rate": 0.1,
- "secondary_tax_rate": 0.1,
- "updated_at": "2019-08-24T14:15:22Z",
- "subject": "string",
- "purchase_order": "string",
- "type": "MatterBill",
- "memo": "string",
- "start_at": "2019-08-24",
- "end_at": "2019-08-24",
- "balance": 0.1,
- "state": "draft",
- "kind": "revenue_kind",
- "total": 0.1,
- "paid": 0.1,
- "paid_at": "2019-08-24T14:15:22Z",
- "pending": 0.1,
- "due": 0.1,
- "discount_services_only": "string",
- "can_update": true,
- "credits_issued": 0.1,
- "shared": true,
- "last_sent_at": "2019-08-24T14:15:22Z",
- "services_secondary_tax": 0.1,
- "services_sub_total": 0.1,
- "services_tax": 0.1,
- "services_taxable_sub_total": 0,
- "services_secondary_taxable_sub_total": 0,
- "taxable_sub_total": 0,
- "secondary_taxable_sub_total": 0,
- "sub_total": 0.1,
- "tax_sum": 0.1,
- "secondary_tax_sum": 0.1,
- "total_tax": 0.1,
- "available_state_transitions": "awaiting_approval"
}, - "communication": {
- "id": 0,
- "etag": "string",
- "subject": "string",
- "body": "string",
- "type": "EmailCommunication",
- "date": "2019-08-24",
- "time_entries_count": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "received_at": "2019-08-24T14:15:22Z"
}, - "client_portal": {
- "id": 0,
- "etag": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "unread_count": 0,
- "unread_notifiable_count": 0
}, - "matter": {
- "id": 0,
- "etag": "string",
- "number": 0,
- "display_number": "string",
- "custom_number": "string",
- "description": "string",
- "status": "Pending",
- "location": "string",
- "client_reference": "string",
- "client_id": 0,
- "billable": true,
- "maildrop_address": "string",
- "billing_method": "flat",
- "open_date": "2019-08-24",
- "close_date": "2019-08-24",
- "pending_date": "2019-08-24",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "shared": true,
- "has_tasks": true,
- "last_activity_date": "2019-08-24",
- "matter_stage_updated_at": "2019-08-24T14:15:22Z"
}, - "matter_note": {
- "id": 0,
- "etag": "string",
- "type": "Matter",
- "subject": "string",
- "detail": "string",
- "date": "2019-08-24",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "time_entries_count": 0
}, - "contact_note": {
- "id": 0,
- "etag": "string",
- "type": "Matter",
- "subject": "string",
- "detail": "string",
- "date": "2019-08-24",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "time_entries_count": 0
}, - "subject": {
- "id": 0,
- "type": "Task",
- "identifier": "string",
- "secondary_identifier": "string",
- "tertiary_identifier": "string"
}, - "timer": {
- "id": 0,
- "etag": "string",
- "start_time": "2019-08-24T14:15:22Z",
- "elapsed_time": 0.1,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "user": {
- "account_owner": true,
- "clio_connect": true,
- "court_rules_default_attendee": true,
- "created_at": "2019-08-24T14:15:22Z",
- "default_calendar_id": 0,
- "email": "string",
- "enabled": true,
- "etag": "string",
- "first_name": "string",
- "id": 0,
- "initials": "string",
- "last_name": "string",
- "name": "string",
- "phone_number": "string",
- "rate": 0.1,
- "roles": [
- "string"
], - "subscription_type": "Attorney",
- "time_zone": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "utbms_expense": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "code": "string",
- "description": "string",
- "type": "UtbmsTask",
- "utbms_set_id": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "vendor": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "first_name": "string",
- "middle_name": "string",
- "last_name": "string",
- "date_of_birth": "2019-08-24",
- "type": "Company",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "prefix": "string",
- "title": "string",
- "initials": "string",
- "clio_connect_email": "string",
- "locked_clio_connect_email": true,
- "client_connect_user_id": 0,
- "primary_email_address": "string",
- "secondary_email_address": "string",
- "primary_phone_number": "string",
- "secondary_phone_number": "string",
- "ledes_client_id": "string",
- "has_clio_for_clients_permission": true,
- "is_client": true,
- "is_clio_for_client_user": true,
- "is_co_counsel": true,
- "is_bill_recipient": true,
- "sales_tax_number": "string"
}, - "calendar_entry": {
- "id": "string",
- "etag": "string",
- "calendar_owner_id": 0
}, - "task": {
- "id": 0,
- "etag": "string"
}, - "text_message_conversation": {
- "id": 0,
- "etag": "string"
}, - "document_version": {
- "id": 0,
- "document_id": 0,
- "etag": "string",
- "uuid": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "filename": "string",
- "size": 0,
- "version_number": 0,
- "content_type": "string",
- "received_at": "2019-08-24T14:15:22Z",
- "put_url": "string",
- "fully_uploaded": true
}, - "legal_aid_uk_activity": {
- "activity_sub_category": "string",
- "advocacy": 0,
- "base_rate": 0.1,
- "bolt_ons": "string",
- "court": 0,
- "eligible_for_sqm": true,
- "expert": 0,
- "form_of_civil_legal_service": 0,
- "id": 0,
- "is_custom_rate": true,
- "json_key": "string",
- "region": 0,
- "tax_exclusive": true,
- "uplift": 0.1,
- "user_type": 0
}
}
}
Delete a single Activity
Outlines the parameters, optional and required, used when deleting the record for a single Activity
path Parameters
id required | integer <int64> The unique identifier for the Activity. |
header Parameters
X-API-VERSION | string The API minor version. Default: latest version. |
Responses
Response samples
- 403
{- "error": {
- "type": "string",
- "message": "string"
}
}
Activity Descriptions are custom Time Entry templates. Activity Descriptions help firms expedite their process for recording Time Entries, and ensure that their Time Entry descriptions are consistent.
Return the data for all ActivityDescriptions
Outlines the parameters, optional and required, used when requesting the data for all ActivityDescriptions
query Parameters
created_since | string <date-time> Filter ActivityDescription records to those having the |
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
flat_rate | boolean Filter ActivityDescription records to those that have a flat rate, or not. |
ids[] | integer <int64> Filter ActivityDescription records to those having the specified unique identifiers. |
limit | integer <int32> A limit on the number of ActivityDescription records to be returned. Limit can range between 1 and 200. Default: |
page_token | string A token specifying which page to return. |
rate_for[matter_id] | integer <int64> Matter id for rate calculation. |
rate_for[user_id] | integer <int64> User id for rate calculation. If not provided, the user associated to the API request is assumed. |
type | string Enum: "utbms" "clio" Filter ActivityDescription records to those of a specific type. |
updated_since | string <date-time> Filter ActivityDescription records to those having the |
user_id | integer <int64> The unique identifier for a single User. The keyword |
header Parameters
X-API-VERSION | string The API minor version. Default: latest version. |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": [
- {
- "id": 0,
- "etag": "string",
- "name": "string",
- "visible_to_co_counsel": true,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "default": true,
- "type": "string",
- "utbms_activity_id": 0,
- "utbms_task_name": "string",
- "utbms_task_id": 0,
- "xero_service_code": "string",
- "accessible_to_user": true,
- "category_type": "string",
- "groups": [
- {
- "client_connect_user": true,
- "etag": "string",
- "id": 0,
- "name": "string",
- "type": "UserGroup",
- "updated_at": "2019-08-24T14:15:22Z"
}
], - "rate": {
- "amount": 0.1,
- "non_billable_amount": 0.1,
- "type": "User",
- "hierarchy": "Default"
}, - "utbms_task": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "code": "string",
- "description": "string",
- "type": "UtbmsTask",
- "utbms_set_id": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "utbms_activity": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "code": "string",
- "description": "string",
- "type": "UtbmsTask",
- "utbms_set_id": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
]
}
Create a new ActivityDescription
Outlines the parameters and data fields used when creating a new ActivityDescription
query Parameters
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
header Parameters
X-API-VERSION | string The API minor version. Default: latest version. |
Request Body schema: optional
Request Body for Activity Descriptions
required | object | ||||||||||
|
Responses
Request samples
- Payload
{- "data": {
- "default": true,
- "groups": [
- {
- "id": 0
}
], - "name": "string",
- "rate": {
- "amount": 0,
- "non_billable_amount": 0,
- "type": "User"
}, - "visible_to_co_counsel": true
}
}
Response samples
- 201
- 400
- 401
- 403
- 404
- 422
- 429
{- "data": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "visible_to_co_counsel": true,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "default": true,
- "type": "string",
- "utbms_activity_id": 0,
- "utbms_task_name": "string",
- "utbms_task_id": 0,
- "xero_service_code": "string",
- "accessible_to_user": true,
- "category_type": "string",
- "groups": [
- {
- "client_connect_user": true,
- "etag": "string",
- "id": 0,
- "name": "string",
- "type": "UserGroup",
- "updated_at": "2019-08-24T14:15:22Z"
}
], - "rate": {
- "amount": 0.1,
- "non_billable_amount": 0.1,
- "type": "User",
- "hierarchy": "Default"
}, - "utbms_task": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "code": "string",
- "description": "string",
- "type": "UtbmsTask",
- "utbms_set_id": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "utbms_activity": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "code": "string",
- "description": "string",
- "type": "UtbmsTask",
- "utbms_set_id": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
}
Return the data for a single ActivityDescription
Outlines the parameters, optional and required, used when requesting the data for a single ActivityDescription
path Parameters
id required | integer <int64> The unique identifier for the ActivityDescription. |
query Parameters
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
header Parameters
IF-MODIFIED-SINCE | string <date> The server will send the requested resource with a 200 status, but only if it has been modified after the given date. (Expects an RFC 2822 timestamp). |
IF-NONE-MATCH | string The server will send the requested resource with a 200 status, but only if the existing resource's ETag doesn't match any of the values listed. |
X-API-VERSION | string The API minor version. Default: latest version. |
Responses
Response samples
- 200
- 400
- 401
- 403
- 404
- 429
{- "data": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "visible_to_co_counsel": true,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "default": true,
- "type": "string",
- "utbms_activity_id": 0,
- "utbms_task_name": "string",
- "utbms_task_id": 0,
- "xero_service_code": "string",
- "accessible_to_user": true,
- "category_type": "string",
- "groups": [
- {
- "client_connect_user": true,
- "etag": "string",
- "id": 0,
- "name": "string",
- "type": "UserGroup",
- "updated_at": "2019-08-24T14:15:22Z"
}
], - "rate": {
- "amount": 0.1,
- "non_billable_amount": 0.1,
- "type": "User",
- "hierarchy": "Default"
}, - "utbms_task": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "code": "string",
- "description": "string",
- "type": "UtbmsTask",
- "utbms_set_id": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "utbms_activity": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "code": "string",
- "description": "string",
- "type": "UtbmsTask",
- "utbms_set_id": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
}
Update a single ActivityDescription
Outlines the parameters and data fields used when updating a single ActivityDescription
path Parameters
id required | integer <int64> The unique identifier for the ActivityDescription. |
query Parameters
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
header Parameters
IF-MATCH | string The server will update the requested resource and send back a 200 status, but only if value in the header matches the existing resource's ETag. |
X-API-VERSION | string The API minor version. Default: latest version. |
Request Body schema: optional
Request Body for Activity Descriptions
required | object | ||||||||||
|
Responses
Request samples
- Payload
{- "data": {
- "default": true,
- "groups": [
- {
- "id": 0,
- "_deleted": true
}
], - "name": "string",
- "rate": {
- "amount": 0,
- "non_billable_amount": 0,
- "type": "User"
}, - "visible_to_co_counsel": true
}
}
Response samples
- 200
- 400
- 401
- 403
- 404
- 412
- 422
- 429
{- "data": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "visible_to_co_counsel": true,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "default": true,
- "type": "string",
- "utbms_activity_id": 0,
- "utbms_task_name": "string",
- "utbms_task_id": 0,
- "xero_service_code": "string",
- "accessible_to_user": true,
- "category_type": "string",
- "groups": [
- {
- "client_connect_user": true,
- "etag": "string",
- "id": 0,
- "name": "string",
- "type": "UserGroup",
- "updated_at": "2019-08-24T14:15:22Z"
}
], - "rate": {
- "amount": 0.1,
- "non_billable_amount": 0.1,
- "type": "User",
- "hierarchy": "Default"
}, - "utbms_task": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "code": "string",
- "description": "string",
- "type": "UtbmsTask",
- "utbms_set_id": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "utbms_activity": {
- "id": 0,
- "etag": "string",
- "name": "string",
- "code": "string",
- "description": "string",
- "type": "UtbmsTask",
- "utbms_set_id": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
}
Delete a single ActivityDescription
Outlines the parameters, optional and required, used when deleting the record for a single ActivityDescription
path Parameters
id required | integer <int64> The unique identifier for the ActivityDescription. |
header Parameters
X-API-VERSION | string The API minor version. Default: latest version. |
Responses
Response samples
- 403
{- "error": {
- "type": "string",
- "message": "string"
}
}
Return the data for all ActivityRates
Outlines the parameters, optional and required, used when requesting the data for all ActivityRates
query Parameters
co_counsel_contact_id | integer <int64> The unique identifier for a single Contact. The keyword |
contact_id | integer <int64> The unique identifier for a single Contact. The keyword |
created_since | string <date-time> Filter ActivityRate records to those having the |
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
ids[] | integer <int64> Filter ActivityRate records to those having the specified unique identifiers. |
limit | integer <int32> A limit on the number of ActivityRate records to be returned. Limit can range between 1 and 200. Default: |
page_token | string A token specifying which page to return. |
updated_since | string <date-time> Filter ActivityRate records to those having the |
header Parameters
X-API-VERSION | string The API minor version. Default: latest version. |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": [
- {
- "id": 0,
- "etag": "string",
- "rate": 0.1,
- "flat_rate": true,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "contact_id": 0,
- "co_counsel_contact_id": 0,
- "user": {
- "account_owner": true,
- "clio_connect": true,
- "court_rules_default_attendee": true,
- "created_at": "2019-08-24T14:15:22Z",
- "default_calendar_id": 0,
- "email": "string",
- "enabled": true,
- "etag": "string",
- "first_name": "string",
- "id": 0,
- "initials": "string",
- "last_name": "string",
- "name": "string",
- "phone_number": "string",
- "rate": 0.1,
- "roles": [
- "string"
], - "subscription_type": "Attorney",
- "time_zone": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "group": {
- "client_connect_user": true,
- "etag": "string",
- "id": 0,
- "name": "string",
- "type": "UserGroup",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
]
}
Create a new ActivityRate
Outlines the parameters and data fields used when creating a new ActivityRate
query Parameters
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
header Parameters
X-API-VERSION | string The API minor version. Default: latest version. |
Request Body schema: optional
Request Body for Activity Rates
required | object | ||||||||
|
Responses
Request samples
- Payload
{- "data": {
- "co_counsel_contact_id": 0,
- "contact_id": 0,
- "flat_rate": true,
- "rate": 0.1
}
}
Response samples
- 201
- 400
- 401
- 403
- 404
- 422
- 429
{- "data": {
- "id": 0,
- "etag": "string",
- "rate": 0.1,
- "flat_rate": true,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "contact_id": 0,
- "co_counsel_contact_id": 0,
- "user": {
- "account_owner": true,
- "clio_connect": true,
- "court_rules_default_attendee": true,
- "created_at": "2019-08-24T14:15:22Z",
- "default_calendar_id": 0,
- "email": "string",
- "enabled": true,
- "etag": "string",
- "first_name": "string",
- "id": 0,
- "initials": "string",
- "last_name": "string",
- "name": "string",
- "phone_number": "string",
- "rate": 0.1,
- "roles": [
- "string"
], - "subscription_type": "Attorney",
- "time_zone": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "group": {
- "client_connect_user": true,
- "etag": "string",
- "id": 0,
- "name": "string",
- "type": "UserGroup",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
}
Return the data for a single ActivityRate
Outlines the parameters, optional and required, used when requesting the data for a single ActivityRate
path Parameters
id required | integer <int64> The unique identifier for the ActivityRate. |
query Parameters
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
header Parameters
IF-MODIFIED-SINCE | string <date> The server will send the requested resource with a 200 status, but only if it has been modified after the given date. (Expects an RFC 2822 timestamp). |
IF-NONE-MATCH | string The server will send the requested resource with a 200 status, but only if the existing resource's ETag doesn't match any of the values listed. |
X-API-VERSION | string The API minor version. Default: latest version. |
Responses
Response samples
- 200
- 400
- 401
- 403
- 404
- 429
{- "data": {
- "id": 0,
- "etag": "string",
- "rate": 0.1,
- "flat_rate": true,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "contact_id": 0,
- "co_counsel_contact_id": 0,
- "user": {
- "account_owner": true,
- "clio_connect": true,
- "court_rules_default_attendee": true,
- "created_at": "2019-08-24T14:15:22Z",
- "default_calendar_id": 0,
- "email": "string",
- "enabled": true,
- "etag": "string",
- "first_name": "string",
- "id": 0,
- "initials": "string",
- "last_name": "string",
- "name": "string",
- "phone_number": "string",
- "rate": 0.1,
- "roles": [
- "string"
], - "subscription_type": "Attorney",
- "time_zone": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "group": {
- "client_connect_user": true,
- "etag": "string",
- "id": 0,
- "name": "string",
- "type": "UserGroup",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
}
Update a single ActivityRate
Outlines the parameters and data fields used when updating a single ActivityRate
path Parameters
id required | integer <int64> The unique identifier for the ActivityRate. |
query Parameters
fields | string The fields to be returned. See response samples for what fields are available. For more information see the fields section. |
header Parameters
IF-MATCH | string The server will update the requested resource and send back a 200 status, but only if value in the header matches the existing resource's ETag. |
X-API-VERSION | string The API minor version. Default: latest version. |
Request Body schema: optional
Request Body for Activity Rates
required | object | ||||||||
|
Responses
Request samples
- Payload
{- "data": {
- "co_counsel_contact_id": 0,
- "contact_id": 0,
- "flat_rate": true,
- "rate": 0.1
}
}
Response samples
- 200
- 400
- 401
- 403
- 404
- 412
- 422
- 429
{- "data": {
- "id": 0,
- "etag": "string",
- "rate": 0.1,
- "flat_rate": true,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "contact_id": 0,
- "co_counsel_contact_id": 0,
- "user": {