Circle-circle intersection API

Intersection of two circles, classifying the relation (separate/tangent/intersecting/contained) and returning the crossing points. Answers 'do these circles overlap, and where do they cross?'.

Price$0.02per request

MethodPOST

Route/v1/geometry/circle-circle-intersect

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

intersectioncircletangentradical-line2dgeometry

API URLhttps://x402.hexl.dev/v1/geometry/circle-circle-intersect

Integration docs

Example request

{
  "c1": [
    0,
    0
  ],
  "r1": 2,
  "c2": [
    3,
    0
  ],
  "r2": 2
}

Example response

{
  "count": 2,
  "relation": "intersecting",
  "points": [
    [
      1.5,
      1.322875656
    ],
    [
      1.5,
      -1.322875656
    ]
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "c1",
    "r1",
    "c2",
    "r2"
  ],
  "properties": {
    "c1": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "examples": [
        [
          0,
          0
        ]
      ]
    },
    "r1": {
      "type": "number",
      "examples": [
        2
      ]
    },
    "c2": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "examples": [
        [
          3,
          0
        ]
      ]
    },
    "r2": {
      "type": "number",
      "examples": [
        2
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}