---
id: apimatic-core-interfaces
version: "0.1.8"
license: MIT
license_treatment: permissive
maintenance: active
---

# apimatic-core-interfaces — An abstract layer of the functionalities provided by apimatic-core-library, requests-client-adapter and APIMatic SDKs.

License: permissive · Maintenance: active · Downloads: 145.7K/mo

## What it is and what it does

apimatic-core-interfaces is a collection of abstract base classes and type definitions that define the contract layer for APIMatic's SDK ecosystem. It specifies interfaces for HTTP clients, response factories, authentication schemes, logging, and webhook signature verification—allowing different implementations to be swapped without breaking dependent code.

The package contains no runtime dependencies and is designed purely as an abstraction layer. It defines interfaces like HttpClient, ResponseFactory, Authentication, UnionType, Logger, ApiLogger, and SignatureVerifier, along with supporting types such as Request and HttpMethodEnum. This separation of concerns lets APIMatic SDKs and the core library evolve independently while maintaining a stable contract.

Use it for:

- Building custom HTTP client adapters that conform to APIMatic's interface contract
- Implementing authentication schemes for APIMatic-generated SDKs
- Creating webhook signature verifiers for validating incoming events
- Extending APIMatic SDKs with custom logging or response handling
- Developing alternative response factories that transform adapter responses into custom HTTP models

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides abstract interfaces and type definitions for APIMatic's core library, enabling HTTP clients, authentication, logging, and webhook signature verification without tight coupling between modules.

Yes, if you are developing or extending APIMatic SDKs or integrating with APIMatic's core library. The package is actively maintained, has no dependencies, and carries no security vulnerabilities. It is lightweight and purely a contract layer, so installation friction is minimal. Not relevant for general-purpose Python development outside the APIMatic ecosystem.

## Install

pip install apimatic-core-interfaces
uv add apimatic-core-interfaces
poetry add apimatic-core-interfaces

## Installing apimatic-core-interfaces

Before you install: Low install friction with no runtime dependencies. Active maintenance as of 289 days ago with a recent commit on 2026-08-01. No known vulnerabilities.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart:

pip install apimatic-core-interfaces

from apimatic_core_interfaces.client.http_client import HttpClient
from apimatic_core_interfaces.types.authentication import Authentication

Requires Python 3.7 or later

Verify before relying:

- Whether the package is actively used by APIMatic SDKs or only serves as a reference layer
- Performance characteristics when used as an abstraction layer in high-throughput scenarios
- Stability guarantees for the interface contracts across minor version updates

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 145.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

abstract interfaces for http clients, apimatic core library interfaces, authentication and logger interfaces, webhook signature verification, framework-agnostic http request types, union type validation interfaces, sdk interface contracts, interface-contracts, apimatic-ecosystem, http-abstraction

[View on SkillFed](https://skillfed.io/packages/apimatic-core-interfaces) · [View on PyPI](https://pypi.org/project/apimatic-core-interfaces/)