Get Details of a Chart of Account Segment

AppZen

Updated On: July 13, 2023 11:46

Fetches the details of a chart of account segment by uuid - the AppZen generated unique identifier for this Chart of Account Segment.
For calling the API, you will need the uuid.

Request URI

GET https://api.appzen.com/dictionary-data-services/chart-of-accounts/{{uuid}}

Header Parameters

Name	Type	Description	Required
x-api-key	String	The x-api-key provided to authorize the request.	Yes
customer-id	String	The Customer ID provided to authorize the request.	Yes
customer-key	String	The Customer Key provided to authorize the request.	Yes

Path Parameters

Name	Type	Description	Required
uuid	String	Globally unique identifier for an uploaded document	Yes

Sample Request

curl -X GET "https://api.appzen.com/dictionary-data-services/chart-of-accounts/TestCOA" 
  -H "accept: application/json" 
  -H "x-api-key: R7wsFxxxx" 
  -H "customer-id: 1004xxxx" 
  -H "customer-key: 15d1xxxx"

Sample Response

Success

{
  "customer_id": "string",
  "appzen_segment_type": "LOCATION_SEGMENT",
  "segment_type": "Location",
  "segment_name": "USA",
  "segment_code": "2099",
  "segment_lookup_names": [
    "ca_locations",
    "hr_locations"
  ],
  "custom_json": {},
  "active": true,
  "valid_start_date": "2020-11-01T11:01:00Z",
  "valid_end_date": "2020-11-01T11:01:00Z",
  "uuid": "5fc03087-d265-11e7-b8c6-83e29cd24f4c"
}

Failure

The request fails if you enter an invalid URL.

 {
  "timestamp": "2019-01-17T16:12:45.977+0000",
  "status": 404,
  "error": "Not Found",
  "message": "Error code : 17e3338d - The resource you specified cannot be not found"
}

Response Code

Response Code	Description
200	The request is successful.
400	The request failed due to a malformed request syntax. Check the requested URL, including the parameters.
401	The request failed due to an authorization issue. For example, the Customer Key could be missing or invalid.
403	The request failed due to a permission issue. The x-api key may not have permission to perform the request.
404	The request failed as the resource is not found. Check the requested URL.
500	The request failed due to an AppZen server issue.

See Also