Billiecart API

<back to all web services

SearchAllEmployersRequest

Requires Authentication
Requires the role:manager
The following routes are available for this service:
GET/employers
SearchOperationTenanted<TResponse> Parameters:
NameParameterData TypeRequiredDescription
OrganisationIdformstringNo
SearchOperationUnTenanted<TResponse> Parameters:
NameParameterData TypeRequiredDescription
DistinctformstringNo
Limitformint?No
Offsetformint?No
SortformstringNo
FilterformstringNo
SearchformstringNo
GetOperationUnTenanted<TResponse> Parameters:
NameParameterData TypeRequiredDescription
EmbedformstringNo
SearchAllEmployersResponse Parameters:
NameParameterData TypeRequiredDescription
ResponseStatusformResponseStatusNo
EmployersformList<Employer>No
MetadataformSearchMetadataNo
Employer Parameters:
NameParameterData TypeRequiredDescription
NameformstringNo
BusinessDetailsformBusinessDetailsNo
ContactformContactNo
PostalAddressformAddressNo
PhysicalAddressformAddressNo
IdformstringNo
BusinessDetails Parameters:
NameParameterData TypeRequiredDescription
TradingNameformstringNo
AustralianBusinessNumberformstringNo
AustralianCompanyNumberformstringNo
Contact Parameters:
NameParameterData TypeRequiredDescription
ContactNameformstringNo
EmailformstringNo
PhoneNumberformstringNo
PreferredContactMethodformstringNo
Address Parameters:
NameParameterData TypeRequiredDescription
AddressLine1formstringNo
AddressLine2formstringNo
SuburbformstringNo
StateTerritoryformstringNo
PostcodeformstringNo
SearchMetadata Parameters:
NameParameterData TypeRequiredDescription
TotalformintNo
LimitformintNo
OffsetformintNo
SortformSortingNo
FilterformFilteringNo
Sorting Parameters:
NameParameterData TypeRequiredDescription
ByformstringNo
DirectionformSortDirectionNo
SortDirection Enum:
Ascending
Descending
Filtering Parameters:
NameParameterData TypeRequiredDescription
FieldsformList<string>No
SearchformstringNo
SearchAllEmployersResponse Parameters:
NameParameterData TypeRequiredDescription
ResponseStatusformResponseStatusNo
EmployersformList<Employer>No
MetadataformSearchMetadataNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /employers HTTP/1.1 
Host: staging-api.billiecart.com.au 
Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	responseStatus: 
	{
		errorCode: String,
		message: String,
		stackTrace: String,
		errors: 
		[
			{
				errorCode: String,
				fieldName: String,
				message: String,
				meta: 
				{
					String: String
				}
			}
		],
		meta: 
		{
			String: String
		}
	},
	employers: 
	[
		{
			name: String,
			businessDetails: 
			{
				tradingName: String,
				australianBusinessNumber: String,
				australianCompanyNumber: String
			},
			contact: 
			{
				contactName: String,
				email: String,
				phoneNumber: String,
				preferredContactMethod: String
			},
			postalAddress: 
			{
				addressLine1: String,
				addressLine2: String,
				suburb: String,
				stateTerritory: String,
				postcode: String
			},
			physicalAddress: 
			{
				addressLine1: String,
				addressLine2: String,
				suburb: String,
				stateTerritory: String,
				postcode: String
			},
			id: String
		}
	],
	metadata: 
	{
		total: 0,
		limit: 0,
		offset: 0,
		sort: 
		{
			by: String,
			direction: Ascending
		},
		filter: 
		{
			fields: 
			[
				String
			],
			search: String
		}
	}
}