---
updatedAt: 2026-04-20T19:56:08.000Z
agentTools:
siteIndex: https://developers.pismo.io/llms.txt
projectIndex: https://developers.pismo.io/pismo-docs/llms.txt
---
# Get division
Retrieves a division by its division code.
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "Banking - Transaction banking",
"version": "0.9.0",
"description": "Transaction banking API",
"contact": {
"name": "API Support",
"url": "https://developers.pismo.io/support/"
},
"license": {
"name": "Copyright Pismo"
}
},
"servers": [
{
"url": "https://sandbox.pismolabs.io",
"description": "Sandbox API server for testing"
}
],
"security": [
{
"BearerAuth": []
}
],
"tags": [
{
"name": "Divisions",
"description": "Divisions endpoints"
}
],
"components": {
"parameters": {
"DivisionCodePath": {
"name": "divisionCode",
"in": "path",
"description": "Division code registered in the [Create division](https://developers.pismo.io/pismo-docs/reference/post-division-v2) endpoint.",
"schema": {
"type": "string",
"maxLength": 36,
"pattern": "^[a-zA-Z0-9-]+$"
},
"required": true,
"example": "my-division-code"
}
},
"schemas": {
"AdministrativeDivisionID": {
"type": "integer",
"format": "int64",
"description": "Administrative division ID. Specifying an administrative division ID in this field links your division to it. This is useful when you want to use the holidays defined in that administrative division.
\n\n**NOTE**: `administrative_division_id` points to [holiday calendar](https://developers.pismo.io/pismo-docs/reference/post-add-holiday-to-calendar). Administrative division is deprecated and replaced by holiday calendar, and both continue to use the same underlying data structure for backward compatibility. The administrative division ID is functionally equivalent to `holiday_calendar_id` and refers to the calendar that defines holidays and working days.\nFor more information, refer to [Add holiday](https://developers.pismo.io/pismo-docs/reference/post-add-holiday-to-calendar).\n",
"example": 13
},
"DivisionDescription": {
"type": "string",
"nullable": true,
"maxLength": 80,
"description": "Division description",
"example": "NY - New York City"
},
"DivisionID": {
"type": "string",
"description": "The Pismo platform generates the division ID when you use the [Create division](https://developers.pismo.io/pismo-docs/reference/post-division-v2) endpoint.\n\nThis ID is immutable and cannot be changed.\n",
"format": "uuid",
"example": "6f8a456a-8b1a-4022-a2f8-7612595330b5"
},
"DivisionName": {
"type": "string",
"description": "Division name",
"example": "NY",
"maxLength": 40
},
"ErrorCode": {
"description": "Error code\n`minLength: 1`\n`maxLength: 12`\n",
"type": "string",
"minLength": 1,
"maxLength": 12,
"example": "WPMT0017"
},
"ErrorMessage": {
"description": "Error message\n`minLength: 1`\n`maxLength: 1000`\n",
"type": "string",
"minLength": 1,
"maxLength": 1000,
"example": "Invalid JSON payload received: Error unmarshalling request"
},
"ErrorResponse": {
"type": "object",
"properties": {
"code": {
"$ref": "#/components/schemas/ErrorCode"
},
"message": {
"$ref": "#/components/schemas/ErrorMessage"
}
}
},
"GetDivisionResponseV2": {
"description": "Get division response body",
"type": "object",
"properties": {
"hierarchy_id": {
"$ref": "#/components/schemas/HierarchyID"
},
"level_id": {
"$ref": "#/components/schemas/LevelID"
},
"name": {
"$ref": "#/components/schemas/DivisionName"
},
"division_id": {
"$ref": "#/components/schemas/DivisionID"
},
"administrative_division_id": {
"$ref": "#/components/schemas/AdministrativeDivisionID"
},
"parent_code": {
"$ref": "#/components/schemas/ParentCode"
},
"description": {
"$ref": "#/components/schemas/DivisionDescription"
},
"timezone": {
"$ref": "#/components/schemas/Timezone"
},
"program_ids": {
"$ref": "#/components/schemas/ProgramIDs"
},
"schema": {
"$ref": "#/components/schemas/SchemaCreateTransactionBankingAccount"
}
},
"required": [
"name",
"hierarchy_id",
"level_id"
]
},
"HierarchyID": {
"type": "string",
"description": "Hierarchy ID generated by the [Create hierarchy](https://developers.pismo.io/pismo-docs/reference/post-hierarchies) endpoint.",
"format": "uuid",
"maxLength": 36,
"example": "9bb95e15-c0e6-4c84-b644-350c76a83358"
},
"LevelID": {
"type": "string",
"description": "Level ID generated by the [Create hierarchy](https://developers.pismo.io/pismo-docs/reference/post-hierarchies) endpoint.",
"format": "uuid",
"maxLength": 36,
"example": "9bb95e15-c0e6-4c84-b644-350c76a83358"
},
"ParentCode": {
"type": "string",
"description": "Division code that can be set as the parent of the division being created. The parent must be at a level with a lower index than the division being created. It must comply with the rule `^[a-zA-Z0-9-]+$`.",
"pattern": "^[a-zA-Z0-9-]+$",
"example": "my-parent-division"
},
"ProgramIDs": {
"type": "array",
"maxItems": 100,
"description": "List of allowed program IDs. The programs must belong to the organization.\nThis list is used for validation during the [Create transaction banking account](https://developers.pismo.io/pismo-docs/reference/post-account) process.\nYou can retrieve the organization programs using the [List programs](https://developers.pismo.io/pismo-docs/reference/programs-1) endpoint.\nIf no program IDs are specified, this division inherits the `program_ids` list from the parent division, if it exists.\n",
"items": {
"type": "integer",
"format": "int32",
"example": 1
},
"example": [
1,
2,
3
]
},
"SchemaCreateTransactionBankingAccount": {
"type": "object",
"description": "Valid JSON Schema as defined at https://json-schema.org/specification.html.\nThis schema validates the JSON custom fields used in the\n[Create transaction banking account](https://developers.pismo.io/pismo-docs/reference/post-account) process.\nIf this field is not set, the division inherits its schema from the parent\ndivision, if one exists.\nThe example below is shown in YAML for readability; the API requires JSON.\n",
"example": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://example.com/product.schema.json",
"title": "Product",
"description": "A product from Acme's catalog",
"type": "object",
"properties": {
"product_id": {
"description": "Product ID",
"type": "integer",
"format": "int64",
"example": 1234
}
},
"required": [
"product_id"
]
}
},
"Timezone": {
"type": "string",
"description": "Division timezone in timezone database format.
\nThis value is used in the calculations for holidays, weekends, and daily balances. If a timezone is not specified, the division inherits the timezone from its parent division. If the parent division also lacks a specified timezone, Pismo defaults to using UTC.\nTo clear this field, specify an empty string.\n",
"example": "America/New_York"
}
},
"responses": {
"401Unauthorized": {
"description": "Access token is missing or invalid"
},
"403Forbidden": {
"description": "The request has been lost"
},
"500InternalServer": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"Generic internal error": {
"value": {
"code": "ECMN9999",
"message": "Internal error"
}
}
}
}
}
}
},
"securitySchemes": {
"BearerAuth": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "JWT"
}
}
},
"paths": {
"/corporate/v2/divisions/{divisionCode}": {
"get": {
"summary": "Get division",
"operationId": "get-division-by-code-v2",
"description": "Retrieves a division by its division code.",
"parameters": [
{
"$ref": "#/components/parameters/DivisionCodePath"
}
],
"tags": [
"Divisions"
],
"responses": {
"200": {
"description": "Get division response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/GetDivisionResponseV2"
},
"examples": {
"Division response": {
"value": {
"hierarchy_id": "9bb95e15-c0e6-4c84-b644-350c76a83358",
"level_id": "7d574f66-ebd0-4b83-85a1-98ce7569e5c3",
"name": "NORAM",
"division_id": "6f8a456a-8b1a-4022-a2f8-7612595330b5",
"administrative_division_id": 13,
"parent_code": "my-parent-division",
"description": "North American regional division",
"program_ids": [
111,
222,
333
],
"timezone": "Pacific Standard Time",
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://example.com/product.schema.json",
"title": "Product",
"description": "A product from Acme's catalog",
"type": "object",
"properties": {
"product_id": {
"description": "Product ID",
"type": "integer",
"format": "int64",
"example": 1234
}
},
"required": [
"product_id"
]
}
}
}
}
}
}
},
"401": {
"$ref": "#/components/responses/401Unauthorized"
},
"403": {
"$ref": "#/components/responses/403Forbidden"
},
"404": {
"description": "Not Found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"Division not found": {
"value": {
"code": "WDIV0002",
"message": "Division not found"
}
},
"Parent division not found": {
"value": {
"code": "WDIV0017",
"message": "Parent division not found"
}
}
}
}
}
},
"500": {
"$ref": "#/components/responses/500InternalServer"
}
}
}
}
}
}
```