Lawmatics Phone Numbers API
A Phone Number is contact information that belongs to a Firm, Contact, or Company.
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-phone-numbers-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 Phone Numbers 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: Phone Numbers
description: A Phone Number is contact information that belongs to a Firm, Contact, or Company.
paths:
/v1/phone_numbers/{phone_number_id}:
get:
operationId: getPhoneNumber
summary: Phone Number
description: A specific Phone Number by id
tags:
- Phone Numbers
parameters:
- name: phone_number_id
in: path
required: true
description: The phone number id
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
examples:
getPhoneNumber:
summary: GET Phone Number
value:
data:
id: '514'
type: phone_number
attributes:
label: Primary
info: '9989888888'
relationships:
informationable:
data:
id: '520'
type: contact
'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: updatePhoneNumber
summary: Update Phone Number
description: Updates a Phone Number by id
tags:
- Phone Numbers
parameters:
- name: phone_number_id
in: path
required: true
description: The phone number id
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
examples:
putUpdatePhoneNumber:
summary: PUT Update Phone Number
value:
data:
id: '514'
type: phone_number
attributes:
label: Primary
info: '9989888888'
relationships:
informationable:
data:
id: '520'
type: contact
'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: deletePhoneNumber
summary: Delete Phone Number
description: 'Delete a Phone Number
phone_number_id: ID of the Phone Number to delete'
tags:
- Phone Numbers
parameters:
- name: phone_number_id
in: path
required: true
description: The phone number id
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
examples:
delDeletePhoneNumber:
summary: DEL Delete Phone Number
value:
data:
id: '514'
type: phone_number
attributes:
label: Primary
info: '9989888888'
relationships:
informationable:
data:
id: '520'
type: contact
'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/phone_numbers:
get:
operationId: getPhoneNumbers
summary: Phone Numbers
description: A paginated list of all Phone Numbers in Lawmatics
tags:
- Phone Numbers
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
examples:
getPhoneNumbers:
summary: GET Phone Numbers
value:
data:
- id: '514'
type: phone_number
attributes:
label: Primary
info: '9989888888'
relationships:
informationable:
data:
id: '520'
type: contact
- id: '512'
type: phone_number
attributes:
label: Primary
info: '9989888888'
relationships:
informationable:
data:
id: '519'
type: contact
- id: '503'
type: phone_number
attributes:
label: Home
info: 916-234-5677
relationships:
informationable:
data:
id: '58'
type: company
- id: '502'
type: phone_number
attributes:
label: Other
info: 916-235-5678
relationships:
informationable:
data:
id: '58'
type: company
- id: '499'
type: phone_number
attributes:
label: Primary
info: 800-555-1234
relationships:
informationable:
data:
id: '58'
type: company
- id: '497'
type: phone_number
attributes:
label: Primary
info: 123-123-1234
relationships:
informationable:
data:
id: '534'
type: contact
- id: '495'
type: phone_number
attributes:
label: Primary
info: 800-987-6543
relationships:
informationable:
data:
id: '57'
type: company
- id: '493'
type: phone_number
attributes:
label: Home
info: 916-234-5677
relationships:
informationable:
data:
id: '55'
type: company
- id: '492'
type: phone_number
attributes:
label: Other
info: 916-235-5678
relationships:
informationable:
data:
id: '55'
type: company
- id: '489'
type: phone_number
attributes:
label: Primary
info: 800-555-1234
relationships:
informationable:
data:
id: '55'
type: company
- id: '487'
type: phone_number
attributes:
label: Home
info: 916-234-5677
relationships:
informationable:
data:
id: '54'
type: company
- id: '486'
type: phone_number
attributes:
label: Other
info: 916-235-5678
relationships:
informationable:
data:
id: '54'
type: company
- id: '483'
type: phone_number
attributes:
label: Primary
info: 800-555-1234
relationships:
informationable:
data:
id: '54'
type: company
- id: '481'
type: phone_number
attributes:
label: Home
info: 916-234-5677
relationships:
informationable:
data:
id: '53'
type: company
- id: '480'
type: phone_number
attributes:
label: Other
info: 916-235-5678
relationships:
informationable:
data:
id: '53'
type: company
- id: '477'
type: phone_number
attributes:
label: Primary
info: 800-555-1234
relationships:
informationable:
data:
id: '53'
type: company
- id: '475'
type: phone_number
attributes:
label: Home
info: 916-234-5677
relationships:
informationable:
data:
id: '52'
type: company
- id: '474'
type: phone_number
attributes:
label: Primary
info: 916-235-5678
relationships:
informationable:
data:
id: '52'
type: company
- id: '471'
type: phone_number
attributes:
label: Home
info: 916-234-5677
relationships:
informationable:
data:
id: '51'
type: company
- id: '470'
type: phone_number
attributes:
label: Primary
info: 916-235-5678
relationships:
informationable:
data:
id: '51'
type: company
- id: '467'
type: phone_number
attributes:
label: Home
info: 916-234-5677
relationships:
informationable:
data:
id: '50'
type: company
- id: '466'
type: phone_number
attributes:
label: Primary
info: 916-235-5678
relationships:
informationable:
data:
id: '50'
type: company
- id: '463'
type: phone_number
attributes:
label: Home
info: 916-234-5677
relationships:
informationable:
data:
id: '49'
type: company
- id: '462'
type: phone_number
attributes:
label: Primary
info: 916-235-5678
relationships:
informationable:
data:
id: '49'
type: company
- id: '459'
type: phone_number
attributes:
label: Primary
info: 800-555-1234
relationships:
informationable:
data:
id: '49'
type: company
meta:
total_pages: 6
limit_per_page: 25
total_entries: 143
links:
self: /v1/phone_numbers?page=1
next: /v1/phone_numbers?page=2
'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: createPhoneNumber
summary: Create Phone Number
description: 'Create a new Phone Number
Required Fields: informationable, label, info
info: The Phone Number string.
label: The Phone Number''s label e.g. Primary.
informationable_type: Prospect, Contact, Company, or Firm that the Phone Number belongs to.
informationable_id: Id of Record. Firm type doesn''t need an ID passed and it will be ignored.
Note - Setting the Phone Number through a Prospect (Matter) will set the address on the Prospects'' Contact/Company.'
tags:
- Phone Numbers
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
label:
type: string
info:
type: string
informationable_type:
type: string
informationable_id:
type: string
responses:
'201':
description: Created
content:
application/json:
schema:
type: object
examples:
createPhoneNumber:
summary: Create Phone Number
value:
data:
id: '514'
type: phone_number
attributes:
label: Primary
info: '9989888888'
relationships:
informationable:
data:
id: '520'
type: contact
'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.'