Lawmatics Custom Fields API
The Custom Fields API from Lawmatics — 2 operation(s) for custom fields.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/lawmatics-custom-fields-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Lawmatics OAuth Custom Fields API
version: 1.22.0
description: The official Lawmatics REST API for legal CRM, client intake and law firm automation.
contact:
name: Lawmatics API Support
email: api@lawmatics.com
url: https://docs.lawmatics.com/
termsOfService: https://www.lawmatics.com/terms-of-use
servers:
- url: https://api.lawmatics.com
description: Lawmatics production API
security:
- oauth2: []
- bearerAuth: []
tags:
- name: Custom Fields
paths:
/v1/custom_fields/{custom_field_id}:
get:
operationId: getCustomField
summary: Custom Field
description: Specific Custom Field metadata by ID
tags:
- Custom Fields
parameters:
- name: custom_field_id
in: path
required: true
description: The custom field id
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
examples:
getCustomField:
summary: GET Custom Field
value:
data:
id: '13'
type: custom_field
attributes:
name: Jurisdiction
type: PracticeArea
field_type: list
practice_area: Criminal Defense
list_options:
- id: 4
name: West County
- id: 3
name: East County
- id: 2
name: South County
- id: 1
name: North County
created_at: '2018-01-08T10:05:25.432-08:00'
updated_at: '2018-01-08T10:05:25.432-08:00'
'401':
description: Unauthorized - missing or invalid OAuth 2.0 bearer token
'429':
description: Too Many Requests - the per-firm rate limit was exceeded; a Retry-After header is returned
headers:
Retry-After:
description: Seconds to wait before retrying
schema:
type: integer
put:
operationId: updateCustomField
summary: Update Custom Field
description: Update an existing Custom Field by ID.
tags:
- Custom Fields
parameters:
- name: custom_field_id
in: path
required: true
description: The custom field id
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
example:
name: Jurisprudence 6ada4e0f-2d2b-4915-90dd-60851e0cb64b
type: Contact
field_type: multi_picklist
list_options:
- 10
- 20
- 30
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
examples:
putUpdateCustomField:
summary: PUT Update Custom Field
value:
data:
id: '7'
type: custom_field
attributes:
name: Jurisprudence
type: Contact
field_type: multi_picklist
list_options:
- id: 18
name: '10'
- id: 19
name: '20'
- id: 20
name: '30'
created_at: '2022-06-02T12:03:29.977-07:00'
updated_at: '2022-06-02T12:06:07.154-07:00'
visibility: default
'401':
description: Unauthorized - missing or invalid OAuth 2.0 bearer token
'429':
description: Too Many Requests - the per-firm rate limit was exceeded; a Retry-After header is returned
headers:
Retry-After:
description: Seconds to wait before retrying
schema:
type: integer
delete:
operationId: deleteCustomField
summary: Delete Custom Field
tags:
- Custom Fields
parameters:
- name: custom_field_id
in: path
required: true
description: The custom field id
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
examples:
deleteDeleteCustomField:
summary: DELETE Delete Custom Field
value:
data:
id: '7'
type: custom_field
attributes:
name: Jurisprudence
type: Contact
field_type: multi_picklist
list_options: []
created_at: '2022-06-02T12:03:29.977-07:00'
updated_at: '2022-06-02T12:10:42.915-07:00'
visibility: default
'401':
description: Unauthorized - missing or invalid OAuth 2.0 bearer token
'429':
description: Too Many Requests - the per-firm rate limit was exceeded; a Retry-After header is returned
headers:
Retry-After:
description: Seconds to wait before retrying
schema:
type: integer
/v1/custom_fields:
get:
operationId: getCustomFields
summary: Custom Fields
description: A paginated list of all Custom Field metadata in Lawmatics
tags:
- Custom Fields
parameters:
- name: fields
in: query
required: false
schema:
type: string
example: all
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
examples:
getCustomFields:
summary: GET Custom Fields
value:
data:
- id: '4638'
type: custom_field
attributes:
name: Test Date
field_type: date
visibility: default
type: Prospect
created_at: '2018-09-24T12:31:05.231-07:00'
updated_at: '2018-10-12T14:23:23.732-07:00'
- id: '1'
type: custom_field
attributes:
name: Test Practice Area Checkbox
field_type: boolean
visibility: default
type: PracticeArea
created_at: '2018-07-17T15:27:16.765-07:00'
updated_at: '2018-10-12T14:24:58.670-07:00'
- id: '4627'
type: custom_field
attributes:
name: Test User Lookup
field_type: lookup
visibility: default
type: Prospect
lookup_type: User
created_at: '2018-08-28T17:19:04.897-07:00'
updated_at: '2018-10-12T14:22:00.976-07:00'
- id: '4639'
type: custom_field
attributes:
name: Test Time
field_type: time
visibility: default
type: Prospect
created_at: '2018-09-24T12:31:15.295-07:00'
updated_at: '2018-10-12T14:23:35.585-07:00'
- id: '4644'
type: custom_field
attributes:
name: Test Contact String
field_type: string
visibility: default
type: Contact
created_at: '2018-10-10T17:38:24.915-07:00'
updated_at: '2018-10-12T14:24:42.034-07:00'
- id: '4631'
type: custom_field
attributes:
name: Test DateTime
field_type: datetime
visibility: hidden
type: Prospect
created_at: '2018-09-06T16:33:22.026-07:00'
updated_at: '2018-10-12T14:23:43.570-07:00'
- id: '7'
type: custom_field
attributes:
name: Test Client String
field_type: string
visibility: default
type: Client
created_at: '2018-07-22T13:37:40.043-07:00'
updated_at: '2018-10-12T14:24:01.079-07:00'
- id: '4'
type: custom_field
attributes:
name: Test Client Currency
field_type: currency
visibility: default
type: Client
created_at: '2018-07-22T13:00:57.587-07:00'
updated_at: '2018-10-12T14:24:08.556-07:00'
- id: '2'
type: custom_field
attributes:
name: Status
field_type: list
visibility: default
type: Prospect
list_options:
- id: 1
name: Open
- id: 2
name: Closed Won
- id: 3
name: Closed Lost
created_at: '2018-07-21T10:30:31.322-07:00'
updated_at: '2018-08-23T16:53:20.710-07:00'
- id: '5'
type: custom_field
attributes:
name: Test Practice Area Text
field_type: text
visibility: default
type: PracticeArea
created_at: '2018-07-22T13:01:26.681-07:00'
updated_at: '2018-10-12T14:24:48.621-07:00'
- id: '8'
type: custom_field
attributes:
name: Test Money Field
field_type: currency
visibility: default
type: Prospect
created_at: '2018-07-22T14:25:40.345-07:00'
updated_at: '2018-08-23T16:53:20.807-07:00'
- id: '9'
type: custom_field
attributes:
name: Test PNC Lookup
field_type: lookup
visibility: starred
type: Prospect
lookup_type: Prospect
created_at: '2018-08-03T18:12:09.181-07:00'
updated_at: '2018-10-12T14:22:44.470-07:00'
- id: '6'
type: custom_field
attributes:
name: Test PNC Picklist
field_type: list
visibility: starred
type: Prospect
list_options:
- id: 9
name: Blue
- id: 11
name: Red
created_at: '2018-07-22T13:17:19.943-07:00'
updated_at: '2018-08-23T16:53:20.791-07:00'
'401':
description: Unauthorized - missing or invalid OAuth 2.0 bearer token
'429':
description: Too Many Requests - the per-firm rate limit was exceeded; a Retry-After header is returned
headers:
Retry-After:
description: Seconds to wait before retrying
schema:
type: integer
post:
operationId: createCustomField
summary: Create Custom Field
description: 'Create a new Custom Field
Name: Custom Field''s name
Type: One of Matter, Contact, Company, Client, or PracticeArea
Visibility (optional): starred, hidden, default (default)
field_type: One of integer, boolean, string, text, currency, date, time, datetime, list, lookup, multi_picklist
list_options: Required if field_type is list or multi_picklist, two options at minimum
lookup_type: Required if field_type is lookup. One of User, Contact, Company or Prospect
practice_area: Name of practice area. Required if type is PracticeArea'
tags:
- Custom Fields
requestBody:
required: true
content:
application/json:
schema:
type: object
example:
name: Jurisdiction b50ceffa-1b5b-40c8-8a36-248485ee0eaf
type: PracticeArea
field_type: list
practice_area: Divorce
list_options:
- one
- two
- three
responses:
'201':
description: Created
content:
application/json:
schema:
type: object
examples:
postCreateCustomField:
summary: POST Create Custom Field
value:
data:
id: '5'
type: custom_field
attributes:
name: Jurisdiction
type: Prospect
field_type: list
practice_area: High Treason
list_options:
- id: 7
name: one
- id: 8
name: two
- id: 9
name: three
created_at: '2022-06-01T16:09:06.943-07:00'
updated_at: '2022-06-01T16:09:06.943-07:00'
visibility: default
'401':
description: Unauthorized - missing or invalid OAuth 2.0 bearer token
'429':
description: Too Many Requests - the per-firm rate limit was exceeded; a Retry-After header is returned
headers:
Retry-After:
description: Seconds to wait before retrying
schema:
type: integer
components:
securitySchemes:
oauth2:
type: oauth2
description: OAuth 2.0 authorization code grant. Register a developer app at https://app.lawmatics.com/settings/developers (developer settings must be enabled by Lawmatics support). Access tokens are non-expiring; no refresh tokens are issued and scopes are not supported.
flows:
authorizationCode:
authorizationUrl: https://app.lawmatics.com/oauth/authorize
tokenUrl: https://api.lawmatics.com/oauth/token
scopes: {}
bearerAuth:
type: http
scheme: bearer
description: 'The OAuth 2.0 access token is sent as `Authorization: Bearer <access_token>`.'
externalDocs:
description: Official Lawmatics RESTful API documentation (Postman)
url: https://docs.lawmatics.com/
x-provenance:
generated: '2026-08-13'
method: derived
publisher: API Evangelist
source: https://docs.lawmatics.com/api/collections/26379991/2sA3JM7gbw?segregateAuth=true&versionTag=latest
source_type: Postman collection published by Lawmatics as its official API documentation
source_file: postman/lawmatics-oauth-api.postman_collection.json
note: 'NOT published by Lawmatics. Lawmatics publishes no OpenAPI. Every path, method, parameter, request example and response example in this document was converted mechanically from the provider-published Postman collection "Lawmatics OAuth API v1.22.0"; nothing was invented. Schemas are typed as generic objects because the collection carries examples, not JSON Schema. The server URL is the base documented in the collection Param Guide (https://api.lawmatics.com), not the collection''s disabled {{host}} placeholder. The 401 and 429 responses added to every authenticated operation are the provider-documented, globally applicable responses: the collection''s auth guide states a per-firm rate limit applies to all endpoints and returns 429 with a Retry-After header, and https://api.lawmatics.com/v1/contacts was observed returning 401 unauthenticated on 2026-08-13.'