How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Vic.ai Dimensions API

Dimensions are part of your *ERP* **Masterdata**, and represent businesscategories that are associated with invoice line items, that Vic.ai canautomatically assign to invoice line items. These operations allowquerying and manipulation of the dimension data.

Vic.ai Dimensions API is one of 33 APIs that Vic.ai publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Dimensions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 14 operations across 9 paths, and defines 27 schemas. It is described by OpenAPI 3.1.0, at version v10.40.4.

Requests are made against 3 base URLs: https://api.no.stage.vic.ai, https://api.us.vic.ai, https://api.no.vic.ai.

14 operations 9 paths 27 schemas 3 DELETE4 GET4 POST3 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
v10.40.4
Base URL
https://api.us.vic.ai
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Vic.ai Dimensions API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). By default, every request must be authenticated.

Paths & Operations 14

Across 9 paths, the API surfaces 14 operations — 3 DELETE, 4 GET, 4 POST, 3 PUT. Each is listed below with its method, path, parameters, and response codes.

Dimensions 14

Dimensions are part of your ERP Masterdata, and represent business categories that are associated with invoice line items, that Vic.ai can automatically assign to invoice line ite…

GET
/v0/dimensions
List all dimensions
listDimensions 7 params → 2004294XX
POST
/v0/dimensions
Create a dimension
createDimension body → 2014294XX
POST
/v0/dimensions/synchronize
Synchronize Dimensions
synchronizeDimensions → 2044294XX
GET
/v0/dimensions/{id}
Info for a specific dimension
getDimension 2 params → 2004224294XX
PUT
/v0/dimensions/{id}
Upserts a dimension
upsertDimension 3 params body → 2002014224294XX
DELETE
/v0/dimensions/{id}
Deletes a dimension
deleteDimension 2 params → 2014224294XX
GET
/v0/dimensions/{id}/dependencies
List dimension dependencies
listDimensionDependencies 4 params → 2004294XX
PUT
/v0/dimensions/{id}/dependencies
Upsert dimension dependency
replaceDimensionDependencies 2 params body → 2004224294XX
DELETE
/v0/dimensions/{id}/dependencies/{dependent_id}
Delete dimension dependency
deleteDimensionDependency 3 params → 2044294XX
POST
/v0/dimensionDependencies
Bulk upsert dimension dependencies
bulkUpsertDimensionDependencies body → 2004224294XX
GET
/v2/companies/{company_id}/dimensions/{dimension_id}/dependencies
List dimension dependencies
listDimensionDependenciesV2 3 params → 2004XX
PUT
/v2/companies/{company_id}/dimensions/{dimension_id}/dependencies
Upsert dimension dependency
upsertDimensionDependencyV2 2 params body → 2004XX
DELETE
/v2/companies/{company_id}/dimensions/{dimension_id}/dependencies/{dependent_id}
Delete dimension dependency
deleteDimensionDependencyV2 3 params → 2044XX
POST
/v2/companies/{company_id}/dimension_dependencies
Bulk upsert dimension dependencies
bulkUpsertDimensionDependenciesV2 1 param body → 2004XX

Schemas 27

The contract defines 27 schemas that model the data the API accepts and returns. The most detailed are Dimension (11 properties), DimensionUpsert (8 properties), CreateDimension (8 properties), DimensionDependencyUpsertSuccessV2 (5 properties). Each schema is shown below with its type and property counts.

ValidationError
DimensionDependencyUpsertSuccessV2
object
5 properties 3 required
DimensionDependencyUpsertResponseV2
object
1 property 1 required
DimensionDependencyUpsertSuccess
object
3 properties 3 required
Dimension
object
11 properties
InternalId
string
The internal id Vic uses for the record.
ErrorV2
object
2 properties 1 required
DimensionUpsert
object
8 properties 2 required
BulkDimensionDependenciesResponseV2
object
1 property 1 required
DimensionDependency
object
A dimension that depends on another dimension.
4 properties
DimensionDependencyUpsert
object
4 properties 1 required
DimensionDependencyReferenceV2
object
5 properties
NonUniqueDimensionExternalId
DimensionDependenciesResponseV2
object
2 properties 2 required
ExternalData
object
A free form json object that is stored with the record.
PaginationV2
object
2 properties
DimensionDependencyReference
object
3 properties
Dimensions
array
PaginationMetaV2
object
1 property
ExternalId
string
The external id set by the ERP system. It does not have to be a UUID and can be any non empty string desired.
CreateDimension
object
8 properties 2 required
BulkDimensionDependenciesRequest
object
1 property 1 required
Error
object
generic error message in JSON format. Note the 'code' field should match the HTTP status code of the wrapping HTTP request.
2 properties 2 required
ErrorString
string
DimensionDependencyUpsertV2
object
2 properties 2 required
DimensionDependencyV2
object
5 properties
BulkDimensionDependenciesRequestV2
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

vicai-dimensions-api-openapi.yml Raw ↑

Other APIs Vic.ai publishes across the network.

Vic.ai Accounts API
Vic.ai Allowed Senders API
Vic.ai Attachments API
Vic.ai Authentication API
Vic.ai Beta Features API
Vic.ai Bills API
Vic.ai Companies API
Vic.ai Company Settings API
Vic.ai Credit Confirmations API
Vic.ai CSV Reports API
Vic.ai Email Endpoints API
Vic.ai Invoice Approval Flows API
Where this information came from

This is an independent, third-party profile of Vic.ai Dimensions API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.