Skip to content

ID4i API API

by id4i.de

API keyBusiness
Open documentation ↗

Overview

Domain registriert bei united-domains.de

ID4i API is a business API from id4i.de. Requests are authenticated with an API key. It is served over plain HTTP. Its OpenAPI description documents 107 endpoints.

At a glance

Authentication
API key
HTTPS
No
CORS
Unknown
Category
Business
Version
1.0.2
Endpoints
107
Spec updated
2023-03-06

Endpoints

MethodPathWhat it does
POST/account/passwordRequest password reset
PUT/account/passwordVerify password reset
POST/account/registrationRegister user
PUT/account/registrationComplete registration
POST/account/verificationVerify registration
GET/api/v1/apikeysFind API key by organization
POST/api/v1/apikeysCreate API key
GET/api/v1/apikeys/privilegesList all privileges
GET/api/v1/apikeys/{key}Show API key
PUT/api/v1/apikeys/{key}Update API keys
DELETE/api/v1/apikeys/{key}Delete API key
GET/api/v1/apikeys/{key}/privilegesList privileges
POST/api/v1/apikeys/{key}/privilegesAdd privilege
DELETE/api/v1/apikeys/{key}/privilegesRemove privilege
GET/api/v1/apikeys/{key}/privileges/{privilege}/id4nsID4ns of a privilege
POST/api/v1/apikeys/{key}/privileges/{privilege}/id4nsAdd ID4ns of a privilege
DELETE/api/v1/apikeys/{key}/privileges/{privilege}/id4nsRemove id4ns of a privilege
GET/api/v1/billing/{organizationId}Get billing amount of services for a given organization
GET/api/v1/billing/{organizationId}/positionsGet billing positions for a given organization
GET/api/v1/changelog/organization/{organizationId}/List change log entries of an organization
POST/api/v1/collectionsCreate collection
GET/api/v1/collections/{id4n}Find collection
PATCH/api/v1/collections/{id4n}Update collection
DELETE/api/v1/collections/{id4n}Delete collection
GET/api/v1/collections/{id4n}/elementsList contents of the collection
POST/api/v1/collections/{id4n}/elementsAdd elements to collection
DELETE/api/v1/collections/{id4n}/elementsRemove elements from collection
GET/api/v1/countriesList countries
GET/api/v1/documents/{id4n}List documents
GET/api/v1/documents/{id4n}/{organizationId}List organization specific documents
POST/api/v1/documents/{id4n}/{organizationId}Create an document for an id4n
PUT/api/v1/documents/{id4n}/{organizationId}Put an document for an id4n
GET/api/v1/documents/{id4n}/{organizationId}/{fileName}Read document contents
DELETE/api/v1/documents/{id4n}/{organizationId}/{fileName}Delete a document
GET/api/v1/documents/{id4n}/{organizationId}/{fileName}/metadataRetrieve a document (meta-data only, no content)
PATCH/api/v1/documents/{id4n}/{organizationId}/{fileName}/metadataUpdate a document
POST/api/v1/guidsCreate GUID(s)
GET/api/v1/guids/withoutCollectionRetrieve GUIDs not in any collection
GET/api/v1/guids/{id4n}Retrieve GUID information
PATCH/api/v1/guids/{id4n}Change GUID information.
GET/api/v1/history/{id4n}List history
POST/api/v1/history/{id4n}Add history item
GET/api/v1/history/{id4n}/{organizationId}deprecatedDEPRECATED - List history
GET/api/v1/history/{id4n}/{organizationId}/{sequenceId}Get history item
PATCH/api/v1/history/{id4n}/{organizationId}/{sequenceId}Update history item
PUT/api/v1/history/{id4n}/{organizationId}/{sequenceId}/visibilitySet history item visibility
GET/api/v1/id4ns/{id4n}Retrieve ID4n information
GET/api/v1/id4ns/{id4n}/aliasGet all aliases for the given GUID or Collection.
POST/api/v1/id4ns/{id4n}/alias/{aliasType}Add alias for GUID or Collection
DELETE/api/v1/id4ns/{id4n}/alias/{aliasType}Remove aliases from GUID or Collection
GET/api/v1/id4ns/{id4n}/collectionsRetrieve collections of an ID
GET/api/v1/id4ns/{id4n}/propertiesRetrieve ID4n properties
PATCH/api/v1/id4ns/{id4n}/propertiesPatch ID4n properties
DELETE/api/v1/id4ns/{id4n}/propertiesDelete ID4n properties
POST/api/v1/import/gs1Import GS1/MAPP codes
GET/api/v1/infoRetrieve version information about ID4i
GET/api/v1/microstorage/{id4n}/{organization}Read data from microstorage
PUT/api/v1/microstorage/{id4n}/{organization}Write data to microstorage
GET/api/v1/multiple/id4ns/propertiesGet multiple ID4n properties
POST/api/v1/organizationsCreate organization
GET/api/v1/organizations/{organizationId}Find organization by id/namespace
PUT/api/v1/organizations/{organizationId}Update organization
DELETE/api/v1/organizations/{organizationId}Delete organization
GET/api/v1/organizations/{organizationId}/addresses/billingRetrieve billing address
PUT/api/v1/organizations/{organizationId}/addresses/billingStore billing address
DELETE/api/v1/organizations/{organizationId}/addresses/billingRemove billing address
GET/api/v1/organizations/{organizationId}/addresses/defaultRetrieve address
PUT/api/v1/organizations/{organizationId}/addresses/defaultStore address
GET/api/v1/organizations/{organizationId}/collectionsGet collections of organization
POST/api/v1/organizations/{organizationId}/logoUpdate organization logo
DELETE/api/v1/organizations/{organizationId}/logoDelete organization logo
GET/api/v1/organizations/{organizationId}/messaginggetDefaultQueue
PATCH/api/v1/organizations/{organizationId}/messagingpatchDefaultQueue
POST/api/v1/organizations/{organizationId}/messaging/enqueueCustomMessageEnqueue a custom message
GET/api/v1/organizations/{organizationId}/partnerGet partners of an organization
PUT/api/v1/organizations/{organizationId}/partnerAdd partner
DELETE/api/v1/organizations/{organizationId}/partnerRemove partner
GET/api/v1/organizations/{organizationId}/privilegesList my privileges
GET/api/v1/organizations/{organizationId}/rolesList users and their roles
GET/api/v1/organizations/{organizationId}/usersFind users in organization
POST/api/v1/organizations/{organizationId}/users/inviteInvite Users
GET/api/v1/organizations/{organizationId}/users/{username}/rolesGet user roles by username
POST/api/v1/organizations/{organizationId}/users/{username}/rolesAdd role(s) to user
DELETE/api/v1/organizations/{organizationId}/users/{username}/rolesRemove role(s) from user
GET/api/v1/public/documents/{id4n}List public documents
GET/api/v1/public/documents/{id4n}/{organizationId}/{fileName}Read public document contents
GET/api/v1/public/documents/{id4n}/{organizationId}/{fileName}/metadataRetrieve a public document (meta-data only, no content)
GET/api/v1/public/history/{id4n}Shows the public history of the given GUID
GET/api/v1/public/image/{imageID}Resolve image
GET/api/v1/public/organizations/{organizationId}Read public organization information
GET/api/v1/public/routes/{id4n}Retrieve all public routes for a GUID
GET/api/v1/rolesList roles
GET/api/v1/routingfiles/{id4n}Retrieve routing file
PUT/api/v1/routingfiles/{id4n}Store routing file
GET/api/v1/routingfiles/{id4n}/route/{type}Retrieve current route of a GUID (or ID4N)
GET/api/v1/routingfiles/{id4n}/routes/{type}Retrieve all routes of a GUID (or ID4N)
GET/api/v1/search/guidsSearch for GUIDs by alias
GET/api/v1/search/guids/aliases/typesList all supported alias types
PUT/api/v1/transfers/{id4n}/receiveInfoTransfer a GUID or collection, obtaining it (i.e. becoming the holder) and if allowed also taking ownership
GET/api/v1/transfers/{id4n}/sendInfoShow transfer preparation information

Showing the first 100 of 107 endpoints; the full list is in the documentation.

Questions

Does the ID4i API API need an API key?

Yes. The ID4i API API uses API key authentication; the documentation explains how to get credentials.

Does the ID4i API API support HTTPS?

The ID4i API API is listed as HTTP only, so avoid sending secrets to it.

How many endpoints does the ID4i API API have?

Its OpenAPI description lists 107 endpoints in version 1.0.2. The first 100 are shown on this page.

What are alternatives to the ID4i API API?

Other Business APIs include Gmail, Google Analytics, Apache Superset, Trello, Square.

Compare alternatives →

Listed from APIs.guru (CC0).