Feign logo

Feign

Feign (OpenFeign) is a declarative Java HTTP client binder inspired by Retrofit, JAX-RS, and WebSocket. It turns annotated interfaces into templated HTTP requests with pluggable encoders, decoders, error handlers, and HTTP transports. The OpenFeign organization maintains a large set of modules covering serialization (Jackson, Gson, Moshi, FastJSON2, JAXB, SAX, SOAP), HTTP transports (OkHttp, Apache HttpClient, Java 11 client, Ribbon), JAX-RS contracts, resilience (Hystrix), logging (SLF4J), form encoding, GraphQL, and metrics.

12 APIs 0 Features
HTTP ClientJavaJVMOpen SourceRESTSDKs

APIs

Feign Core

Feign Core is the base library that processes annotated Java interfaces into templated HTTP requests. It defines the contract, encoder, decoder, and client abstractions used acr...

Feign Jackson

Feign Jackson module provides Jackson-based JSON encoding and decoding for Feign-annotated client interfaces, the most common serialization choice in JVM applications.

Feign Gson

Feign Gson module provides Google Gson-based JSON encoding and decoding for Feign clients, useful in projects already standardized on Gson.

Feign OkHttp

Feign OkHttp module replaces the default JDK HTTP transport with Square's OkHttp client, adding HTTP/2, connection pooling, and modern transport features.

Feign Apache HttpClient

Feign Apache HttpClient module integrates Apache HttpComponents (HC5) as the underlying HTTP transport for Feign clients.

Feign Java 11 HTTP

Feign Java 11 HTTP module uses the JDK 11+ standard HttpClient as the transport, supporting HTTP/2 and asynchronous calls without external dependencies.

Feign Ribbon

Feign Ribbon module integrates Netflix Ribbon for client-side load balancing across a list of HTTP servers.

Feign Hystrix

Feign Hystrix module wraps Feign client calls in Netflix Hystrix commands, adding circuit breaking, fallbacks, and bulkhead isolation.

Feign JAX-RS

Feign JAX-RS modules let developers reuse JAX-RS 1.x, 2.x, 3.x, and 4.x annotations on Feign client interfaces instead of Feign's native annotation set.

Feign SLF4J

Feign SLF4J module routes Feign request and response logging through the SLF4J facade, integrating with the host application's logging backend.

Feign Form

Feign Form module adds support for application/x-www-form-urlencoded and multipart/form-data request bodies, including file uploads.

Feign Micrometer

Feign Micrometer module exposes Feign client metrics (timings, counts, errors) through Micrometer for shipment to Prometheus, Datadog, and other monitoring backends.

Resources

🔗
Website
Website
🔗
Documentation
Documentation
👥
GitHubOrganization
GitHubOrganization
🔗
Issues
Issues
📄
Releases
Releases
🔗
License
License
🔗
Maven Central
Maven Central

Sources

apis.yml Raw ↑ 
aid: feign
name: Feign
description: >-
  Feign (OpenFeign) is a declarative Java HTTP client binder inspired by
  Retrofit, JAX-RS, and WebSocket. It turns annotated interfaces into
  templated HTTP requests with pluggable encoders, decoders, error handlers,
  and HTTP transports. The OpenFeign organization maintains a large set of
  modules covering serialization (Jackson, Gson, Moshi, FastJSON2, JAXB,
  SAX, SOAP), HTTP transports (OkHttp, Apache HttpClient, Java 11 client,
  Ribbon), JAX-RS contracts, resilience (Hystrix), logging (SLF4J), form
  encoding, GraphQL, and metrics.
type: Index
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
access: 3rd-Party
created: '2026-03-27'
modified: '2026-04-28'
position: Consumer
tags:
- HTTP Client
- Java
- JVM
- Open Source
- REST
- SDKs
url: >-
  https://raw.githubusercontent.com/api-evangelist/feign/refs/heads/main/apis.yml
specificationVersion: '0.19'
apis:
- aid: feign:feign-core
  name: Feign Core
  description: >-
    Feign Core is the base library that processes annotated Java
    interfaces into templated HTTP requests. It defines the contract,
    encoder, decoder, and client abstractions used across the entire
    OpenFeign ecosystem.
  humanURL: https://github.com/OpenFeign/feign
  tags:
  - HTTP Client
  - Java
  - Core
  properties:
  - type: Documentation
    url: https://github.com/OpenFeign/feign#readme
  - type: GettingStarted
    url: https://github.com/OpenFeign/feign#basics
  - type: Source Code
    url: https://github.com/OpenFeign/feign
  - type: Maven Central
    url: https://central.sonatype.com/artifact/io.github.openfeign/feign-core
  - url: graphql/feign-graphql.md
    type: GraphQL
- aid: feign:feign-jackson
  name: Feign Jackson
  description: >-
    Feign Jackson module provides Jackson-based JSON encoding and decoding
    for Feign-annotated client interfaces, the most common serialization
    choice in JVM applications.
  humanURL: https://github.com/OpenFeign/feign/tree/master/jackson
  tags:
  - JSON
  - Jackson
  - Serialization
  properties:
  - type: Documentation
    url: https://github.com/OpenFeign/feign/tree/master/jackson
  - type: Source Code
    url: https://github.com/OpenFeign/feign/tree/master/jackson
- aid: feign:feign-gson
  name: Feign Gson
  description: >-
    Feign Gson module provides Google Gson-based JSON encoding and decoding
    for Feign clients, useful in projects already standardized on Gson.
  humanURL: https://github.com/OpenFeign/feign/tree/master/gson
  tags:
  - JSON
  - Gson
  - Serialization
  properties:
  - type: Documentation
    url: https://github.com/OpenFeign/feign/tree/master/gson
  - type: Source Code
    url: https://github.com/OpenFeign/feign/tree/master/gson
- aid: feign:feign-okhttp
  name: Feign OkHttp
  description: >-
    Feign OkHttp module replaces the default JDK HTTP transport with
    Square's OkHttp client, adding HTTP/2, connection pooling, and modern
    transport features.
  humanURL: https://github.com/OpenFeign/feign/tree/master/okhttp
  tags:
  - HTTP Client
  - Transport
  - OkHttp
  properties:
  - type: Documentation
    url: https://github.com/OpenFeign/feign/tree/master/okhttp
  - type: Source Code
    url: https://github.com/OpenFeign/feign/tree/master/okhttp
- aid: feign:feign-httpclient
  name: Feign Apache HttpClient
  description: >-
    Feign Apache HttpClient module integrates Apache HttpComponents (HC5)
    as the underlying HTTP transport for Feign clients.
  humanURL: https://github.com/OpenFeign/feign/tree/master/httpclient
  tags:
  - HTTP Client
  - Transport
  - Apache
  properties:
  - type: Documentation
    url: https://github.com/OpenFeign/feign/tree/master/httpclient
  - type: Source Code
    url: https://github.com/OpenFeign/feign/tree/master/httpclient
- aid: feign:feign-java11
  name: Feign Java 11 HTTP
  description: >-
    Feign Java 11 HTTP module uses the JDK 11+ standard HttpClient as the
    transport, supporting HTTP/2 and asynchronous calls without external
    dependencies.
  humanURL: https://github.com/OpenFeign/feign/tree/master/java11
  tags:
  - HTTP Client
  - Transport
  - Java 11
  properties:
  - type: Documentation
    url: https://github.com/OpenFeign/feign/tree/master/java11
  - type: Source Code
    url: https://github.com/OpenFeign/feign/tree/master/java11
- aid: feign:feign-ribbon
  name: Feign Ribbon
  description: >-
    Feign Ribbon module integrates Netflix Ribbon for client-side load
    balancing across a list of HTTP servers.
  humanURL: https://github.com/OpenFeign/feign/tree/master/ribbon
  tags:
  - Load Balancing
  - Netflix
  - Resilience
  properties:
  - type: Documentation
    url: https://github.com/OpenFeign/feign/tree/master/ribbon
  - type: Source Code
    url: https://github.com/OpenFeign/feign/tree/master/ribbon
- aid: feign:feign-hystrix
  name: Feign Hystrix
  description: >-
    Feign Hystrix module wraps Feign client calls in Netflix Hystrix
    commands, adding circuit breaking, fallbacks, and bulkhead isolation.
  humanURL: https://github.com/OpenFeign/feign/tree/master/hystrix
  tags:
  - Resilience
  - Circuit Breaker
  - Netflix
  properties:
  - type: Documentation
    url: https://github.com/OpenFeign/feign/tree/master/hystrix
  - type: Source Code
    url: https://github.com/OpenFeign/feign/tree/master/hystrix
- aid: feign:feign-jaxrs
  name: Feign JAX-RS
  description: >-
    Feign JAX-RS modules let developers reuse JAX-RS 1.x, 2.x, 3.x, and
    4.x annotations on Feign client interfaces instead of Feign's native
    annotation set.
  humanURL: https://github.com/OpenFeign/feign/tree/master/jaxrs
  tags:
  - JAX-RS
  - Annotations
  - Contracts
  properties:
  - type: Documentation
    url: https://github.com/OpenFeign/feign/tree/master/jaxrs
  - type: Source Code
    url: https://github.com/OpenFeign/feign/tree/master/jaxrs
- aid: feign:feign-slf4j
  name: Feign SLF4J
  description: >-
    Feign SLF4J module routes Feign request and response logging through
    the SLF4J facade, integrating with the host application's logging
    backend.
  humanURL: https://github.com/OpenFeign/feign/tree/master/slf4j
  tags:
  - Logging
  - Observability
  properties:
  - type: Documentation
    url: https://github.com/OpenFeign/feign/tree/master/slf4j
  - type: Source Code
    url: https://github.com/OpenFeign/feign/tree/master/slf4j
- aid: feign:feign-form
  name: Feign Form
  description: >-
    Feign Form module adds support for application/x-www-form-urlencoded
    and multipart/form-data request bodies, including file uploads.
  humanURL: https://github.com/OpenFeign/feign-form
  tags:
  - Forms
  - Multipart
  - File Upload
  properties:
  - type: Documentation
    url: https://github.com/OpenFeign/feign-form
  - type: Source Code
    url: https://github.com/OpenFeign/feign-form
- aid: feign:feign-micrometer
  name: Feign Micrometer
  description: >-
    Feign Micrometer module exposes Feign client metrics (timings, counts,
    errors) through Micrometer for shipment to Prometheus, Datadog, and
    other monitoring backends.
  humanURL: https://github.com/OpenFeign/feign/tree/master/micrometer
  tags:
  - Metrics
  - Observability
  - Micrometer
  properties:
  - type: Documentation
    url: https://github.com/OpenFeign/feign/tree/master/micrometer
  - type: Source Code
    url: https://github.com/OpenFeign/feign/tree/master/micrometer
common:
- type: Website
  url: https://github.com/OpenFeign/feign
- type: Documentation
  url: https://github.com/OpenFeign/feign#readme
- type: GitHubOrganization
  url: https://github.com/OpenFeign
- type: Issues
  url: https://github.com/OpenFeign/feign/issues
- type: Releases
  url: https://github.com/OpenFeign/feign/releases
- type: License
  url: https://github.com/OpenFeign/feign/blob/master/LICENSE
- type: Maven Central
  url: https://central.sonatype.com/namespace/io.github.openfeign
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com