v2

latestOpenAPI 3.1.0Proprietary - Licensed to Authorized Customers Only2026-07-31611061.1 MB
Unit

Search Units

Search for Units with filtering capabilities.

post/unit/_search

Query parameters

limitinteger
Example:1

The maximum number of Units to return (default: 50) when searching Units

offsetinteger

The number of Units to skip before starting to return results (default: 0) when searching Units

Request body

Example request

{
  "filter": {
    "equals": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "meta": {
        "createdAt": "2024-01-15T10:30:00Z",
        "createdBy": "123e4567-e89b-12d3-a456-426614174000",
        "updatedAt": "2024-01-15T10:30:00Z",
        "updatedBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "external": {
        "sourceID": "example",
        "source": "example"
      },
      "title": "example",
      "description": "example"
    },
    "notEquals": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "meta": {
        "createdAt": "2024-01-15T10:30:00Z",
        "createdBy": "123e4567-e89b-12d3-a456-426614174000",
        "updatedAt": "2024-01-15T10:30:00Z",
        "updatedBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "external": {
        "sourceID": "example",
        "source": "example"
      },
      "title": "example",
      "description": "example"
    },
    "greaterThan": {
      "meta": {
        "createdAt": "2024-01-15T10:30:00Z",
        "updatedAt": "2024-01-15T10:30:00Z"
      }
    },
    "smallerThan": {
      "meta": {
        "createdAt": "2024-01-15T10:30:00Z",
        "updatedAt": "2024-01-15T10:30:00Z"
      }
    },
    "greaterOrEqual": {
      "meta": {
        "createdAt": "2024-01-15T10:30:00Z",
        "updatedAt": "2024-01-15T10:30:00Z"
      }
    },
    "smallerOrEqual": {
      "meta": {
        "createdAt": "2024-01-15T10:30:00Z",
        "updatedAt": "2024-01-15T10:30:00Z"
      }
    },
    "contains": {
      "id": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "meta": {
        "createdBy": [
          "123e4567-e89b-12d3-a456-426614174000"
        ],
        "updatedBy": [
          "123e4567-e89b-12d3-a456-426614174000"
        ]
      },
      "external": {
        "sourceID": [
          "example"
        ],
        "source": [
          "example"
        ]
      },
      "title": [
        "example"
      ],
      "description": [
        "example"
      ]
    },
    "notContains": {
      "id": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "meta": {
        "createdBy": [
          "123e4567-e89b-12d3-a456-426614174000"
        ],
        "updatedBy": [
          "123e4567-e89b-12d3-a456-426614174000"
        ]
      },
      "external": {
        "sourceID": [
          "example"
        ],
        "source": [
          "example"
        ]
      },
      "title": [
        "example"
      ],
      "description": [
        "example"
      ]
    },
    "like": {
      "external": {
        "sourceID": "example",
        "source": "example"
      },
      "title": "example",
      "description": "example"
    },
    "notLike": {
      "external": {
        "sourceID": "example",
        "source": "example"
      },
      "title": "example",
      "description": "example"
    },
    "null": {
      "meta": {
        "createdBy": true,
        "updatedAt": true,
        "updatedBy": true
      },
      "external": {
        "sourceID": true,
        "source": true
      },
      "description": true
    },
    "notNull": {
      "meta": {
        "createdBy": true,
        "updatedAt": true,
        "updatedBy": true
      },
      "external": {
        "sourceID": true,
        "source": true
      },
      "description": true
    },
    "orCondition": true,
    "nestedFilters": [
      {
        "equals": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "meta": {
            "createdAt": "2024-01-15T10:30:00Z",
            "createdBy": "123e4567-e89b-12d3-a456-426614174000",
            "updatedAt": "2024-01-15T10:30:00Z",
            "updatedBy": "123e4567-e89b-12d3-a456-426614174000"
          },
          "external": {
            "sourceID": "example",
            "source": "example"
          },
          "title": "example",
          "description": "example"
        },
        "notEquals": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "meta": {
            "createdAt": "2024-01-15T10:30:00Z",
            "createdBy": "123e4567-e89b-12d3-a456-426614174000",
            "updatedAt": "2024-01-15T10:30:00Z",
            "updatedBy": "123e4567-e89b-12d3-a456-426614174000"
          },
          "external": {
            "sourceID": "example",
            "source": "example"
          },
          "title": "example",
          "description": "example"
        },
        "greaterThan": {
          "meta": {
            "createdAt": "2024-01-15T10:30:00Z",
            "updatedAt": "2024-01-15T10:30:00Z"
          }
        },
        "smallerThan": {
          "meta": {
            "createdAt": "2024-01-15T10:30:00Z",
            "updatedAt": "2024-01-15T10:30:00Z"
          }
        },
        "greaterOrEqual": {
          "meta": {
            "createdAt": "2024-01-15T10:30:00Z",
            "updatedAt": "2024-01-15T10:30:00Z"
          }
        },
        "smallerOrEqual": {
          "meta": {
            "createdAt": "2024-01-15T10:30:00Z",
            "updatedAt": "2024-01-15T10:30:00Z"
          }
        },
        "contains": {
          "id": [
            "123e4567-e89b-12d3-a456-426614174000"
          ],
          "meta": {
            "createdBy": [
              "123e4567-e89b-12d3-a456-426614174000"
            ],
            "updatedBy": [
              "123e4567-e89b-12d3-a456-426614174000"
            ]
          },
          "external": {
            "sourceID": [
              "example"
            ],
            "source": [
              "example"
            ]
          },
          "title": [
            "example"
          ],
          "description": [
            "example"
          ]
        },
        "notContains": {
          "id": [
            "123e4567-e89b-12d3-a456-426614174000"
          ],
          "meta": {
            "createdBy": [
              "123e4567-e89b-12d3-a456-426614174000"
            ],
            "updatedBy": [
              "123e4567-e89b-12d3-a456-426614174000"
            ]
          },
          "external": {
            "sourceID": [
              "example"
            ],
            "source": [
              "example"
            ]
          },
          "title": [
            "example"
          ],
          "description": [
            "example"
          ]
        },
        "like": {
          "external": {
            "sourceID": "example",
            "source": "example"
          },
          "title": "example",
          "description": "example"
        },
        "notLike": {
          "external": {
            "sourceID": "example",
            "source": "example"
          },
          "title": "example",
          "description": "example"
        },
        "null": {
          "meta": {
            "createdBy": true,
            "updatedAt": true,
            "updatedBy": true
          },
          "external": {
            "sourceID": true,
            "source": true
          },
          "description": true
        },
        "notNull": {
          "meta": {
            "createdBy": true,
            "updatedAt": true,
            "updatedBy": true
          },
          "external": {
            "sourceID": true,
            "source": true
          },
          "description": true
        },
        "orCondition": true
      }
    ]
  }
}

Response

Response for Unit Search operation - returns filtered Unit results

Example response

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "meta": {
        "createdAt": "2024-01-15T10:30:00Z",
        "createdBy": "987fcdeb-51a2-43d1-b567-123456789abc",
        "updatedAt": "2024-01-15T14:45:00Z",
        "updatedBy": "987fcdeb-51a2-43d1-b567-123456789abc"
      },
      "external": {
        "sourceID": "12345678",
        "source": "ExternalIntegrationAPI"
      },
      "title": "Norra distriktet",
      "description": "Norra grundskole- och förskoleenheten"
    }
  ],
  "pagination": {
    "limit": 1,
    "total": 100
  }
}