Search Companies
POST/companies/search
> The companies search endpoint is only available on the Propeller cloud version.
Retrieves a list of companies by using the search fields below. Results will be paginated.
Field | Type |
---|---|
dateCreated | DateFilter |
dateModified | DateFilter |
debtorIds | array(string) |
offset | integer |
page | integer |
Date filter
A date filter is a special date search object that can search through a range:
{
"from": "2020-12-12T00:00:00",
"to": "2022-12-12T00:00:00"
}
Request
Query Parameters
Use expands
as a query parameter to fetch additional information for companies like sources, parent, etc.
sources
: if the "expands" parameter contains this value, the response from the API will return additional source information describing where this resource is imported from. If there are no sources for this resource then the sources
property in the response will be just an empty array.
- application/json
Body
dateCreated
object
dateModified
object
Responses
- 200
- 400
Search Companies - 200
Response Headers
Alt-Svc
string
Via
string
alt-svc
string
content-length
string
date
string
return-format
string
x-request-id
string
- application/json
- Schema
- Example (from schema)
- Search Companies - 200
Schema
Array [
- MOD1
- MOD2
- MOD3
- MOD4
- MOD5
- MOD6
]
data
object[]
defaultobjectId
object
anyOf
string
number
string
string
string
string
{
"data": [
{
"authorizeId": "",
"budget": "N",
"budgetInherit": "Y",
"cocNumber": "",
"company": "",
"dateCreated": "2023-05-19T11:46:20",
"dateModified": "2023-05-19T11:46:20",
"debtorId": "755632",
"defaultobjectId": "",
"department": "",
"id": 9478,
"inheritOrderList": "Y",
"inheritProductList": "Y",
"name": "Comapny 1",
"notes": "",
"office": "",
"orderListAllowAll": "U",
"orderListManagerId": "",
"taxNumber": "123456",
"userManagerId": ""
},
{
"authorizeId": "",
"budget": "N",
"budgetInherit": "Y",
"cocNumber": "",
"company": "",
"dateCreated": "2023-05-19T11:54:55",
"dateModified": "2023-05-19T11:54:55",
"debtorId": "755632",
"defaultobjectId": "",
"department": "",
"id": 9479,
"inheritOrderList": "Y",
"inheritProductList": "Y",
"name": "Company 2",
"notes": "",
"office": "",
"orderListAllowAll": "U",
"orderListManagerId": "",
"taxNumber": "123456",
"userManagerId": ""
},
{
"authorizeId": "",
"budget": "N",
"budgetInherit": "Y",
"cocNumber": "",
"company": "",
"dateCreated": "2023-05-19T13:38:00",
"dateModified": "2023-05-19T13:38:00",
"debtorId": "755632",
"defaultobjectId": "",
"department": "",
"id": 9481,
"inheritOrderList": "Y",
"inheritProductList": "Y",
"name": "Company 3",
"notes": "",
"office": "",
"orderListAllowAll": "U",
"orderListManagerId": "",
"taxNumber": "123456",
"userManagerId": ""
},
{
"authorizeId": "",
"budget": "N",
"budgetInherit": "N",
"cocNumber": "75564998",
"company": "",
"dateCreated": "2023-05-22T15:11:46",
"dateModified": "2023-05-23T09:57:24",
"debtorId": "755632",
"defaultobjectId": 944644,
"department": "",
"id": 9482,
"inheritOrderList": "N",
"inheritProductList": "Y",
"name": "Propellor Company",
"notes": "Company created from API",
"office": "",
"orderListAllowAll": "U",
"orderListManagerId": "",
"taxNumber": "",
"userManagerId": ""
},
{
"authorizeId": "",
"budget": "N",
"budgetInherit": "Y",
"cocNumber": "75564998",
"company": "",
"dateCreated": "2023-05-22T15:39:13",
"dateModified": "2023-05-22T15:39:12",
"debtorId": "755632",
"defaultobjectId": "",
"department": "",
"id": 9483,
"inheritOrderList": "N",
"inheritProductList": "Y",
"name": "Propeller Nr.2",
"notes": "Company created from API",
"office": "",
"orderListAllowAll": "U",
"orderListManagerId": "",
"taxNumber": "",
"userManagerId": ""
},
{
"authorizeId": "",
"budget": "N",
"budgetInherit": "Y",
"cocNumber": "",
"company": "",
"dateCreated": "2023-05-26T16:32:55",
"dateModified": "2023-05-26T16:33:19",
"debtorId": "755632",
"defaultobjectId": "",
"department": "",
"id": 9484,
"inheritOrderList": "Y",
"inheritProductList": "Y",
"name": "Company 4",
"notes": "",
"office": "",
"orderListAllowAll": "U",
"orderListManagerId": "",
"taxNumber": "123456",
"userManagerId": ""
},
{
"authorizeId": "",
"budget": "N",
"budgetInherit": "Y",
"cocNumber": "",
"company": "",
"dateCreated": "2023-05-26T16:45:45",
"dateModified": "2023-05-26T16:45:45",
"debtorId": "755632",
"defaultobjectId": "",
"department": "",
"id": 9485,
"inheritOrderList": "Y",
"inheritProductList": "Y",
"name": "Company 5",
"notes": "",
"office": "",
"orderListAllowAll": "U",
"orderListManagerId": "",
"taxNumber": "123456",
"userManagerId": ""
},
{
"authorizeId": "",
"budget": "N",
"budgetInherit": "Y",
"cocNumber": "",
"company": "",
"dateCreated": "2023-05-26T16:53:28",
"dateModified": "2023-05-26T16:54:34",
"debtorId": "755632",
"defaultobjectId": "",
"department": "",
"id": 9486,
"inheritOrderList": "Y",
"inheritProductList": "Y",
"name": "Company 6",
"notes": "",
"office": "",
"orderListAllowAll": "U",
"orderListManagerId": "",
"taxNumber": "123456",
"userManagerId": ""
}
],
"end": 6188,
"itemsFound": 6188,
"messages": [
"Completed"
],
"offset": 12,
"page": 516,
"pages": 516,
"start": 6181,
"total": 8
}
{
"data": [
{
"authorizeId": "",
"budget": "N",
"budgetInherit": "Y",
"cocNumber": "",
"company": "",
"dateCreated": "2023-05-19T11:46:20",
"dateModified": "2023-05-19T11:46:20",
"debtorId": "755632",
"defaultobjectId": "",
"department": "",
"id": 9478,
"inheritOrderList": "Y",
"inheritProductList": "Y",
"name": "Comapny 1",
"notes": "",
"office": "",
"orderListAllowAll": "U",
"orderListManagerId": "",
"taxNumber": "123456",
"userManagerId": ""
},
{
"authorizeId": "",
"budget": "N",
"budgetInherit": "Y",
"cocNumber": "",
"company": "",
"dateCreated": "2023-05-19T11:54:55",
"dateModified": "2023-05-19T11:54:55",
"debtorId": "755632",
"defaultobjectId": "",
"department": "",
"id": 9479,
"inheritOrderList": "Y",
"inheritProductList": "Y",
"name": "Company 2",
"notes": "",
"office": "",
"orderListAllowAll": "U",
"orderListManagerId": "",
"taxNumber": "123456",
"userManagerId": ""
},
{
"authorizeId": "",
"budget": "N",
"budgetInherit": "Y",
"cocNumber": "",
"company": "",
"dateCreated": "2023-05-19T13:38:00",
"dateModified": "2023-05-19T13:38:00",
"debtorId": "755632",
"defaultobjectId": "",
"department": "",
"id": 9481,
"inheritOrderList": "Y",
"inheritProductList": "Y",
"name": "Company 3",
"notes": "",
"office": "",
"orderListAllowAll": "U",
"orderListManagerId": "",
"taxNumber": "123456",
"userManagerId": ""
},
{
"authorizeId": "",
"budget": "N",
"budgetInherit": "N",
"cocNumber": "75564998",
"company": "",
"dateCreated": "2023-05-22T15:11:46",
"dateModified": "2023-05-23T09:57:24",
"debtorId": "755632",
"defaultobjectId": 944644,
"department": "",
"id": 9482,
"inheritOrderList": "N",
"inheritProductList": "Y",
"name": "Propellor Company",
"notes": "Company created from API",
"office": "",
"orderListAllowAll": "U",
"orderListManagerId": "",
"taxNumber": "",
"userManagerId": ""
},
{
"authorizeId": "",
"budget": "N",
"budgetInherit": "Y",
"cocNumber": "75564998",
"company": "",
"dateCreated": "2023-05-22T15:39:13",
"dateModified": "2023-05-22T15:39:12",
"debtorId": "755632",
"defaultobjectId": "",
"department": "",
"id": 9483,
"inheritOrderList": "N",
"inheritProductList": "Y",
"name": "Propeller Nr.2",
"notes": "Company created from API",
"office": "",
"orderListAllowAll": "U",
"orderListManagerId": "",
"taxNumber": "",
"userManagerId": ""
},
{
"authorizeId": "",
"budget": "N",
"budgetInherit": "Y",
"cocNumber": "",
"company": "",
"dateCreated": "2023-05-26T16:32:55",
"dateModified": "2023-05-26T16:33:19",
"debtorId": "755632",
"defaultobjectId": "",
"department": "",
"id": 9484,
"inheritOrderList": "Y",
"inheritProductList": "Y",
"name": "Company 4",
"notes": "",
"office": "",
"orderListAllowAll": "U",
"orderListManagerId": "",
"taxNumber": "123456",
"userManagerId": ""
},
{
"authorizeId": "",
"budget": "N",
"budgetInherit": "Y",
"cocNumber": "",
"company": "",
"dateCreated": "2023-05-26T16:45:45",
"dateModified": "2023-05-26T16:45:45",
"debtorId": "755632",
"defaultobjectId": "",
"department": "",
"id": 9485,
"inheritOrderList": "Y",
"inheritProductList": "Y",
"name": "Company 5",
"notes": "",
"office": "",
"orderListAllowAll": "U",
"orderListManagerId": "",
"taxNumber": "123456",
"userManagerId": ""
},
{
"authorizeId": "",
"budget": "N",
"budgetInherit": "Y",
"cocNumber": "",
"company": "",
"dateCreated": "2023-05-26T16:53:28",
"dateModified": "2023-05-26T16:54:34",
"debtorId": "755632",
"defaultobjectId": "",
"department": "",
"id": 9486,
"inheritOrderList": "Y",
"inheritProductList": "Y",
"name": "Company 6",
"notes": "",
"office": "",
"orderListAllowAll": "U",
"orderListManagerId": "",
"taxNumber": "123456",
"userManagerId": ""
}
],
"end": 6188,
"itemsFound": 6188,
"messages": [
"Completed"
],
"offset": 12,
"page": 516,
"pages": 516,
"start": 6181,
"total": 8
}
Search Companies - 400
Response Headers
Alt-Svc
string
Via
string
alt-svc
string
content-length
string
date
string
return-format
string
x-request-id
string
- application/json
- Schema
- Example (from schema)
- Search Companies - 400
Schema
error
object
{
"error": {
"code": 10007,
"messages": [
"#: extraneous key [name] is not permitted"
],
"moreInfo": "https://www.propel.us/docs/errors/10007",
"status": 400,
"type": "SchemaValidationException"
}
}
{
"error": {
"code": 10007,
"messages": [
"#: extraneous key [name] is not permitted"
],
"moreInfo": "https://www.propel.us/docs/errors/10007",
"status": 400,
"type": "SchemaValidationException"
}
}