Retrofit

Retrofit is a type-safe HTTP client for Android and the JVM (Java and Kotlin) built by Square, turning HTTP API interfaces into callable Java objects with annotation-based configuration and pluggable serialization. Retrofit is built on top of OkHttp and supports synchronous/asynchronous execution, JSON/XML/Protobuf converters, RxJava adapters, and Kotlin coroutines. Current stable version is 3.0.0.

4 APIs 0 Features

AndroidHTTP ClientJavaKotlinLibraryMobileOpen SourceSDKSquare

APIs

Retrofit

Retrofit is a type-safe HTTP client for the JVM that turns annotated Java/Kotlin interfaces into HTTP API calls. Supports all HTTP methods via annotations. Built on OkHttp with ...

Retrofit Converters

Pluggable serialization converters for Retrofit supporting Gson, Moshi, Jackson, Kotlinx Serialization, JAXB, Protocol Buffers (Wire), SimpleXML, and Scalars.

Retrofit Call Adapters

Pluggable call adapters that allow Retrofit interfaces to return RxJava Observables (v1, v2, v3), Java 8 CompletableFuture, Guava ListenableFuture, and Scala Future types.

Retrofit Mock

Provides behavior-simulating implementations of Retrofit interfaces for local testing without requiring a network connection.

Semantic Vocabularies

Retrofit Context

11 classes · 4 properties

JSON-LD

Resources

GitHubOrganization

Sources

aid: retrofit
name: Retrofit
description: >-
  Retrofit is a type-safe HTTP client for Android and the JVM (Java and Kotlin)
  built by Square, turning HTTP API interfaces into callable Java objects with
  annotation-based configuration and pluggable serialization. Retrofit is built
  on top of OkHttp and supports synchronous/asynchronous execution, JSON/XML/Protobuf
  converters, RxJava adapters, and Kotlin coroutines. Current stable version is 3.0.0.
type: Index
image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
tags:
  - Android
  - HTTP Client
  - Java
  - Kotlin
  - Library
  - Mobile
  - Open Source
  - SDK
  - Square
url: >-
  https://raw.githubusercontent.com/api-evangelist/retrofit/refs/heads/main/apis.yml
created: '2026-03-27'
modified: '2026-05-02'
specificationVersion: '0.19'
apis:
  - aid: retrofit:retrofit-core
    name: Retrofit
    description: >-
      Retrofit is a type-safe HTTP client for the JVM that turns annotated
      Java/Kotlin interfaces into HTTP API calls. Supports all HTTP methods via
      annotations. Built on OkHttp with support for synchronous Call, RxJava,
      Java 8 CompletableFuture, and Kotlin coroutines.
    humanURL: https://square.github.io/retrofit/
    tags:
      - Android
      - HTTP Client
      - Java
      - Kotlin
      - Open Source
    properties:
      - type: Documentation
        url: https://square.github.io/retrofit/
      - type: GitHub
        url: https://github.com/square/retrofit
      - type: Changelog
        url: https://github.com/square/retrofit/blob/trunk/CHANGELOG.md
      - type: JavaDoc
        url: https://square.github.io/retrofit/2.x/retrofit/
      - type: JSONSchema
        url: https://raw.githubusercontent.com/api-evangelist/retrofit/refs/heads/main/json-schema/retrofit-library-schema.json
  - aid: retrofit:retrofit-converters
    name: Retrofit Converters
    description: >-
      Pluggable serialization converters for Retrofit supporting Gson, Moshi,
      Jackson, Kotlinx Serialization, JAXB, Protocol Buffers (Wire), SimpleXML,
      and Scalars.
    humanURL: https://square.github.io/retrofit/#converters
    tags:
      - Converters
      - Gson
      - Jackson
      - Moshi
      - Protobuf
      - Serialization
    properties:
      - type: Documentation
        url: https://square.github.io/retrofit/#converters
      - type: GitHub
        url: https://github.com/square/retrofit/tree/trunk/retrofit-converters
  - aid: retrofit:retrofit-adapters
    name: Retrofit Call Adapters
    description: >-
      Pluggable call adapters that allow Retrofit interfaces to return RxJava
      Observables (v1, v2, v3), Java 8 CompletableFuture, Guava ListenableFuture,
      and Scala Future types.
    humanURL: https://square.github.io/retrofit/#call-adapters
    tags:
      - Adapters
      - Async
      - Java 8
      - RxJava
      - Scala
    properties:
      - type: Documentation
        url: https://square.github.io/retrofit/#call-adapters
      - type: GitHub
        url: https://github.com/square/retrofit/tree/trunk/retrofit-adapters
  - aid: retrofit:retrofit-mock
    name: Retrofit Mock
    description: >-
      Provides behavior-simulating implementations of Retrofit interfaces for
      local testing without requiring a network connection.
    humanURL: https://github.com/square/retrofit/tree/trunk/retrofit-mock
    tags:
      - Mock
      - Testing
    properties:
      - type: GitHub
        url: https://github.com/square/retrofit/tree/trunk/retrofit-mock
common:
  - type: Website
    url: https://square.github.io/retrofit/
  - type: Documentation
    url: https://square.github.io/retrofit/
  - type: GitHub
    url: https://github.com/square/retrofit
  - type: GitHubOrganization
    url: https://github.com/square
  - type: Changelog
    url: https://github.com/square/retrofit/blob/trunk/CHANGELOG.md
  - type: Issues
    url: https://github.com/square/retrofit/issues
  - type: Maven
    url: https://search.maven.org/artifact/com.squareup.retrofit2/retrofit
  - type: License
    url: https://github.com/square/retrofit/blob/trunk/LICENSE.txt
  - type: JavaDoc
    url: https://square.github.io/retrofit/2.x/retrofit/
  - type: Vocabulary
    url: https://raw.githubusercontent.com/api-evangelist/retrofit/refs/heads/main/vocabulary/retrofit-vocabulary.yml
maintainers:
  - FN: Kin Lane
    email: [email protected]