Developers

Every visa answer The A Company gives, as a command: the official answer, verified, with its quote and source. The same 16 commands work four ways.

The terminal and agents with a shell
```
npx the-a-company tour
```
Claude Code, Codex, any shell. JSON in, JSON out.
Any program
```
https://api.theacompany.ai
```
The same commands as HTTP. GET / lists them all.
Claude, ChatGPT and any MCP client
```
https://theacompany.ai/mcp
```
Add it as a connector. No sign-in.
Agents that hand tasks to other agents
```
https://theacompany.ai/.well-known/agent-card.json
```
Every command as an A2A skill. A2A 1.0 and 0.3. No sign-in.

A path is the page's address after /visa/: usa/b1-b2/kosovo is theacompany.ai/visa/usa/b1-b2/kosovo. A path not built yet answers coming with the nearest live one.
Errors come back as {"error": {"code", "message"}}. The CLI exits 0 on success, 1 on an error, 2 when a daily limit is reached.
Every example below is a real answer for usa/b1-b2/kosovo, cut short. Apply, the application and chat show its shape.

Start

`tour`

Use this command to list every command with its name and description. Returns one row per command, in order. Prefer <command> --schema when the user needs one command's full input and output.

npx the-a-company tour

Returns

{
  "commands": [
    {
      "name": "tour",
      "description": "Use this command to list every command with its name and description. Returns one row per command, in order. Prefer `…",
      "method": "GET",
      "endpoint": "/api/tour"
    },
    {
      "name": "visa list",
      "description": "Use this command to list every visa we cover, grouped by destination, then type, subtype and the country applied from…",
      "method": "GET",
      "endpoint": "/api/visa/<path>/list"
    },
    {
      "name": "visa get",
      "description": "Use this command to get one visa page in full. Returns the page's JSON, or its Markdown with `--format md`. Prefer `v…",
      "method": "GET",
      "endpoint": "/api/visa/<path>/get"
    },
    "… 13 more"
  ]
}

`visa list`

Use this command to list every visa we cover, grouped by destination, then type, subtype and the country applied from. Returns the tree, each level with its status, live or coming, and its count of each. Prefer visa get when the user already knows the full path.

Parameters

pathstring: The page's address after /visa/. For example usa/j-1.

npx the-a-company visa list usa/j-1

Returns

{
  "path": "usa/j-1",
  "status": "live",
  "live": 15,
  "coming": 90,
  "below": [
    {
      "path": "usa/j-1/au-pair",
      "status": "live",
      "live": 1,
      "coming": 6,
      "below": [
        {
          "path": "usa/j-1/au-pair/kosovo",
          "status": "live",
          "live": 1,
          "coming": 0
        },
        {
          "path": "usa/j-1/au-pair/albania",
          "status": "coming",
          "live": 0,
          "coming": 1
        },
        {
          "path": "usa/j-1/au-pair/bosnia-and-herzegovina",
          "status": "coming",
          "live": 0,
          "coming": 1
        },
        "… 4 more"
      ]
    },
    {
      "path": "usa/j-1/camp-counselor",
      "status": "live",
      "live": 1,
      "coming": 6,
      "below": [
        {
          "path": "usa/j-1/camp-counselor/kosovo",
          "status": "live",
          "live": 1,
          "coming": 0
        },
        {
          "path": "usa/j-1/camp-counselor/albania",
          "status": "coming",
          "live": 0,
          "coming": 1
        },
        {
          "path": "usa/j-1/camp-counselor/bosnia-and-herzegovina",
          "status": "coming",
          "live": 0,
          "coming": 1
        },
        "… 4 more"
      ]
    },
    {
      "path": "usa/j-1/college-and-university-student",
      "status": "live",
      "live": 1,
      "coming": 6,
      "below": [
        {
          "path": "usa/j-1/college-and-university-student/kosovo",
          "status": "live",
          "live": 1,
          "coming": 0
        },
        {
          "path": "usa/j-1/college-and-university-student/albania",
          "status": "coming",
          "live": 0,
          "coming": 1
        },
        {
          "path": "usa/j-1/college-and-university-student/bosnia-and-herzegovina",
          "status": "coming",
          "live": 0,
          "coming": 1
        },
        "… 4 more"
      ]
    },
    "… 12 more"
  ]
}

`visa get`

Use this command to get one visa page in full. Returns the page's JSON, or its Markdown with --format md. Prefer visa steps, visa price or visa documents when the user asks only one thing.

Parameters

pathstringrequired: The page's address after /visa/. For example usa/b1-b2/kosovo.
langen | sq
formatjson | md

npx the-a-company visa get usa/b1-b2/kosovo

Returns

{
  "$schema": "https://theacompany.ai/website/page.schema.json",
  "page": {
    "id": "visa-us-b1-b2-xk-xk",
    "kind": "service",
    "lang": "en",
    "path": "/visa/usa/b1-b2/kosovo",
    "translations": {
      "sq": "/al/viza/amerikane/b1-b2/kosove"
    },
    "for": {
      "service": "visa",
      "country": "us",
      "type": "b1-b2",
      "from": "xk"
    },
    "visa": {
      "name": "U.S. visa for tourism and business (B1/B2)",
      "country": "United States",
      "from": "Kosovo",
      "purposes": [
        "Tourism and business",
        "Tourism, vacation, pleasure visitor",
        "Business visitor",
        "… 3 more"
      ]
    },
    "embassy": {
      "name": "U.S. Embassy Pristina",
      "city": "Pristina",
      "place": "Pristina, Kosovo"
    }
  },
  "seo": {
    "title": "U.S. B1/B2 visa for tourism and business in Kosovo",
    "description": "Fill in the DS-160 application, pay the fee $185, schedule the appointment, prepare the documents, attend the intervi…",
    "image": "/website/social/en/b1-b2-kosovo.jpg"
  },
  "official_answers": {
    "travel-state-wait-times": {
      "name": "Global Visa Wait Times",
      "site": "travel.state.gov",
      "href": "https://travel.state.gov/content/travel/en/us-visas/visa-information-resources/global-visa-wait-times.html",
      "read": "2026-11-10",
      "info": {
        "appointment.wait": {
          "value": 15,
          "unit": "days, under (published: < 0.5 Month)",
          "quote": "Last updated: 21-OCT-2026\n| Pristina | NA | < 0.5 Month | < 0.5 Month | < 0.5 Month | < 0.5 Month |"
        },
        "wait_updated": {
          "value": "October 21, 2026",
          "quote": "Last updated: 21-OCT-2026"
        },
        "wait_checked": {
          "value": "November 10, 2026",
          "quote": "Last updated: 21-OCT-2026"
        }
      }
    },
    "travel-state-reciprocity-kosovo": {
      "name": "Kosovo Reciprocity Schedule",
      "site": "travel.state.gov",
      "href": "https://travel.state.gov/content/travel/en/us-visas/Visa-Reciprocity-and-Civil-Documents-by-Country/Kosovo.html",
      "read": "2026-10-11",
      "info": {
        "visa.validity": {
          "quote": "B-1/B-2 | None | Multiple | 60 Months",
          "value": 5,
          "unit": "years (the schedule: 60 Months)"
        }
      }
    },
    "www-ustraveldocs-com-xk-en-step-2-c55f38": {
      "name": "USTravelDocs",
      "site": "www.ustraveldocs.com",
      "href": "https://www.ustraveldocs.com/xk/en/step-2",
      "read": "2026-10-22",
      "info": {
        "step.ds160": {
          "quote": "Once the form is submitted, you cannot make any changes.\nThe completed DS-160 application form will generate an alpha…"
        },
        "step.book": {
          "quote": "As you go through the process you will be able to select your visa type, enter personal data, add dependents, confirm…"
        },
        "step.interview": {
          "quote": "For your appointment, you must present:"
        },
        "documents.ds160": {
          "quote": "The Form DS-160 must be submitted online and the printed confirmation page must be brought to the interview."
        }
      }
    },
    "www-ustraveldocs-com-xk-en-payment-options-693cd2": {
      "name": "USTravelDocs",
      "site": "www.ustraveldocs.com",
      "href": "https://www.ustraveldocs.com/xk/en/payment-options",
      "read": "2026-10-22",
      "info": {
        "step.pay": {
          "quote": "Once you have paid the visa application fee, make sure to keep the reference number safe. If lost, it cannot be repla…"
        }
      }
    },
    "www-ustraveldocs-com-xk-en-business-visa-57b532": {
      "name": "USTravelDocs",
      "site": "www.ustraveldocs.com",
      "href": "https://www.ustraveldocs.com/xk/en/business-visa",
      "read": "2026-10-15",
      "info": {
        "step.documents": {
          "quote": "You should bring the following documents to your interview. Original documents are always preferred over photocopies …"
        },
        "documents.passport": {
          "quote": "A passport valid for travel to the United States with a validity date at least six months beyond your intended period…"
        },
        "documents.appointment": {
          "quote": "In addition to these items, you must present an interview appointment letter confirming that you booked an appointmen…"
        },
        "documents.photo": {
          "quote": "One 2 x 2-inch (51 x 51 mm) photograph taken within the last six months."
        },
        "documents.bank": {
          "quote": "Also bring evidence of financial support such as monthly bank statements, fixed deposit slips, or other evidence."
        }
      }
    },
    "travel-state-gov-content-travel-en-us-visas-touris-d66404": {
      "name": "Visitor Visa",
      "site": "travel.state.gov",
      "href": "https://travel.state.gov/content/travel/en/us-visas/tourism-visit/visitor.html",
      "read": "2026-10-11",
      "info": {
        "step.decision": {
          "quote": "A consular officer will interview you to determine whether you are qualified to receive a visitor visa."
        },
        "step.travel": {
          "quote": "If you are allowed to enter the United States, the CBP official will provide an admission stamp or a paper Form I-94,…"
        }
      }
    },
    "www-ustraveldocs-com-xk-en-retrieving-your-documen-9f6077": {
      "name": "USTravelDocs",
      "site": "www.ustraveldocs.com",
      "href": "https://www.ustraveldocs.com/xk/en/retrieving-your-documents",
      "read": "2026-10-15",
      "info": {
        "step.dhl": {
          "quote": "Once you complete your consular service with the Embassy, you will be directed to the nearest DHL office\nto provide y…"
        }
      }
    },
    "www-ustraveldocs-com-xk-en-step-6-ce39fe": {
      "name": "USTravelDocs",
      "site": "www.ustraveldocs.com",
      "href": "https://www.ustraveldocs.com/xk/en/step-6",
      "read": "2026-10-12",
      "info": {
        "step.passport": {
          "quote": "If your visa application is approved, your passport and visa will be returned via our courier service. Once the passp…"
        }
      }
    }
  },
  "sections": [
    {
      "section": "hero",
      "id": "hero",
      "title": "Apply for a U.S. visa for tourism and business (B1/B2) in Kosovo",
      "lead": "Fill in the DS-160 application, pay the fee $185, schedule the appointment, prepare the documents, attend the intervi…",
      "placeholder": "Ask about your U.S. visa…",
      "slides": [
        {
          "id": "landmark-04",
          "ask": "Can I visit my son in the U.S.?",
          "art": {
            "image": "/website/hero-landmark-04.webp",
            "alt": "A young man guides his visiting parents along a path as the Golden Gate Bridge appears through light coastal mist",
            "credit": "The A Company"
          }
        },
        {
          "id": "family-03",
          "ask": "Can I visit my daughter in the U.S.?",
          "art": {
            "image": "/website/hero-family-03.webp",
            "alt": "An adult daughter opens the front door to her visiting parents",
            "credit": "The A Company"
          }
        },
        {
          "id": "family-10",
          "ask": "Can I visit my family in the U.S.?",
          "art": {
            "image": "/website/hero-family-10.webp",
            "alt": "A visiting mother and father take a candid group photo with their adult son",
            "credit": "The A Company"
          }
        },
        "… 12 more"
      ]
    },
    {
      "section": "reviews",
      "id": "reviews",
      "style": "badge-under",
      "title": "60,381 customers",
      "words": "The words people use most: “recommend”, “professional”, “smooth”, “clear” and “thank you”.",
      "info": [
        "customers",
        "google_reviews"
      ],
      "rating": {
        "score": "google_rating",
        "count": "google_reviews",
        "href": "office.map"
      },
      "show": 8
    },
    {
      "section": "pricing",
      "id": "pricing",
      "title": "What it costs",
      "items": [
        {
          "id": "visa-fee",
          "name": "Fee for the U.S. visa for tourism and business (B1/B2)",
          "amount": "visa.price",
          "to": "U.S. Department of State",
          "note": "Paid to the U.S. Department of State. Not refunded if the visa is refused.",
          "info": [
            "…"
          ]
        },
        {
          "id": "dhl",
          "name": "DHL's service",
          "amount": "courier.price",
          "to": "DHL",
          "note": "Delivery of your passport with the visa to your home. Only if the visa is approved.",
          "info": [
            "…"
          ]
        },
        {
          "id": "service",
          "name": "The A Company's service",
          "amount": "service.price",
          "to": "The A Company",
          "note": "Filling in the DS-160, paying the fee, booking the appointment, and preparing the documents. Paid to The A Company, w…",
          "info": [
            "…"
          ]
        }
      ],
      "rate": {
        "usd_per_eur": 1.1195,
        "date": "2026-10-14",
        "href": "https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html"
      },
      "pay": {
        "href": "https://buy.stripe.com/8x200ifxP27s0gc6Y02sM2a"
      }
    },
    "… 7 more"
  ],
  "info": {
    "application.url": {
      "value": "https://ceac.state.gov/genniv/",
      "quote": "The DS-160, Online Nonimmigrant Visa Application form, is for temporary travel to the United States, and for K (fianc…",
      "by": "official",
      "source": "travel-state-ds160",
      "read": "2026-10-11"
    },
    "appointment.url": {
      "value": "https://www.ustraveldocs.com/xk/en/step-4",
      "quote": "If an in person interview is required, you can schedule an appointment online using this website",
      "by": "official",
      "source": "ustraveldocs-schedule",
      "read": "2026-10-22"
    },
    "appointment.wait": {
      "value": 15,
      "unit": "days, under (published: < 0.5 Month)",
      "quote": "Last updated: 21-OCT-2026\n| Pristina | NA | < 0.5 Month | < 0.5 Month | < 0.5 Month | < 0.5 Month |",
      "by": "official",
      "source": "travel-state-wait-times",
      "read": "2026-11-10"
    },
    "bags": {
      "quote": "Applicants are not permitted to enter the U.S. Embassy while carrying any of the following items:\nLarge shoulder bags…",
      "by": "official",
      "source": "ustraveldocs-interview",
      "read": "2026-10-22"
    },
    "booking_receipt": {
      "quote": "The reference/receipt number is required to schedule your appointment.",
      "by": "official",
      "source": "ustraveldocs-payment-options",
      "read": "2026-10-22"
    },
    "courier.address": {
      "value": "Street Ahmet Krasniqi 254, 10000 Prishtina, Kosovo",
      "quote": "DHL Office\nDHL Express\nStreet Ahmet Krasniqi 254\n10000 Prishtina\nKosovo",
      "by": "official",
      "source": "dhl-kosovo-help",
      "read": "2026-10-14"
    },
    "courier.delivery": {
      "value": 3,
      "unit": "days",
      "by": "the_a_company",
      "source": "visa-usa-b1-b2-kosovo",
      "read": "2026-10-28"
    },
    "courier.name": {
      "value": "DHL",
      "quote": "If your visa is approved, your passport(s) will be mailed back to your local address via DHL.\nOnce you complete your …",
      "by": "official",
      "source": "ustraveldocs-collection",
      "read": "2026-10-12"
    },
    "courier.price": {
      "value": 10,
      "currency": "EUR",
      "quote": "If your visa is approved, your passport(s) will be mailed back to your local address via DHL.\nto provide your contact…",
      "by": "official",
      "source": "ustraveldocs-collection",
      "read": "2026-10-12"
    },
    "customers": {
      "value": 60381,
      "unit": "customers",
      "by": "the_a_company",
      "source": "company",
      "read": "2026-10-17"
    },
    "…": "61 more"
  },
  "questions": [
    {
      "id": "b1-b2",
      "step": "before",
      "shown": true,
      "q": "What is the difference between B1 and B2?",
      "text": "B1 is for business, B2 for tourism, and B1/B2 for both. With B1 you can meet business associates, attend a conference…",
      "sources": [
        {
          "name": "Visitor Visa",
          "href": "https://travel.state.gov/content/travel/en/us-visas/tourism-visit/visitor.html",
          "read": "2026-10-11"
        }
      ],
      "quote": "Visitor visas are nonimmigrant visas for persons who want to enter the United States temporarily for business (B-1 vi…",
      "asked": [
        {
          "by": "search-console",
          "q": "difference between b1 and b2 visa",
          "clicks": 0,
          "impressions": 962,
          "to": "2026-10-23"
        },
        {
          "by": "search-console",
          "q": "what is b1 and b2 visa",
          "clicks": 0,
          "impressions": 589,
          "to": "2026-10-23"
        },
        {
          "by": "search-console",
          "q": "what is b1 b2 visa",
          "clicks": 0,
          "impressions": 397,
          "to": "2026-10-23"
        }
      ]
    },
    {
      "id": "requirements",
      "step": "before",
      "shown": true,
      "q": "What do I need to show for a U.S. visa for tourism and business (B1/B2)?",
      "text": "The purpose of your trip, that you will leave the United States after it, and that you can pay all its costs. Evidenc…",
      "sources": [
        {
          "name": "Visitor Visa",
          "href": "https://travel.state.gov/content/travel/en/us-visas/tourism-visit/visitor.html",
          "read": "2026-10-11"
        }
      ],
      "quote": "Additional documents may be requested to establish if you are qualified. For example, additional requested documents …",
      "related": [
        "documents"
      ],
      "asked": [
        {
          "by": "https://www.ustraveldocs.com/al/en/general-information",
          "q": "How can an applicant prove “strong ties”?"
        }
      ]
    },
    {
      "id": "work",
      "step": "before",
      "shown": false,
      "q": "Can I work in the United States on a B1/B2 visa?",
      "text": "No. A visitor on a B1/B2 visa may not accept employment or work in the United States; employment needs a different vi…",
      "sources": [
        {
          "name": "Visitor Visa",
          "href": "https://travel.state.gov/content/travel/en/us-visas/tourism-visit/visitor.html",
          "read": "2026-10-11"
        }
      ],
      "quote": "An individual on a visitor visa (B1/B2) is not permitted to accept employment or work in the United States.\nThese are…",
      "asked": [
        {
          "by": "us"
        }
      ]
    },
    "… 46 more"
  ],
  "can_i_apply": {
    "eligibility": [
      {
        "id": "visit_purpose",
        "says": "I am going for business, tourism, or both",
        "sources": [
          {
            "quote": "Visitor visas are nonimmigrant visas for persons who want to enter the United States temporarily for business (B-1 vi…",
            "href": "https://travel.state.gov/content/travel/en/us-visas/tourism-visit/visitor.html",
            "read": "2026-10-11"
          }
        ]
      },
      {
        "id": "no_work_or_study",
        "says": "I will not work or study for credit",
        "instead": [
          "F1",
          "J1",
          "H1B"
        ],
        "sources": [
          {
            "quote": "These are some examples of activities that require different categories of visas and cannot be done while on a visito…",
            "href": "https://travel.state.gov/content/travel/en/us-visas/tourism-visit/visitor.html",
            "read": "2026-10-11"
          },
          {
            "quote": "An individual on a visitor visa (B1/B2) is not permitted to accept employment or work in the United States.",
            "href": "https://travel.state.gov/content/travel/en/us-visas/tourism-visit/visitor.html",
            "read": "2026-10-11"
          }
        ]
      },
      {
        "id": "return_home",
        "says": "I will come back after my trip",
        "sources": [
          {
            "quote": "Additional documents may be requested to establish if you are qualified. For example, additional requested documents …",
            "href": "https://travel.state.gov/content/travel/en/us-visas/tourism-visit/visitor.html",
            "read": "2026-10-11"
          }
        ]
      },
      "… 1 more"
    ],
    "no_visa": [
      {
        "id": "visa_waiver",
        "says": "With a passport from … you do not need a visa for a trip of up to 90 days: you need ESTA.",
        "sources": [
          {
            "quote": "The Visa Waiver Program (VWP) enables most citizens or nationals of participating countries * to travel to the United…",
            "href": "https://travel.state.gov/content/travel/en/us-visas/tourism-visit/visa-waiver-program.html",
            "read": "2026-10-11"
          },
          {
            "quote": "Nationals of VWP countries who have traveled to or been present in Democratic People's Republic of Korea, Iran, Iraq,…",
            "href": "https://travel.state.gov/content/travel/en/us-visas/tourism-visit/visa-waiver-program.html",
            "read": "2026-10-11"
          },
          {
            "quote": "Also, if you intend to stay longer than 90 days, then you need to apply for a visa.",
            "href": "https://travel.state.gov/content/travel/en/us-visas/tourism-visit/visa-waiver-program.html",
            "read": "2026-10-11"
          }
        ]
      },
      {
        "id": "canada",
        "says": "Citizens of Canada do not need a visa to visit the United States.",
        "sources": [
          {
            "quote": "Citizens of Canada traveling to the United States do not require a nonimmigrant visa, except for the travel purposes …",
            "href": "https://travel.state.gov/content/travel/en/us-visas/tourism-visit/citizens-of-canada-and-bermuda.html",
            "read": "2026-10-11"
          }
        ]
      },
      {
        "id": "bermuda",
        "says": "Citizens of Bermuda do not need a visa for a trip of up to 180 days.",
        "sources": [
          {
            "quote": "Citizens of Bermuda traveling to the United States do not require a nonimmigrant visa for travel up to 180 days, exce…",
            "href": "https://travel.state.gov/content/travel/en/us-visas/tourism-visit/citizens-of-canada-and-bermuda.html",
            "read": "2026-10-11"
          }
        ]
      }
    ],
    "documents_only_for_some": [
      {
        "id": "depositslip",
        "name": "U.S. visa deposit slip",
        "only_if": "I pay the visa fee in cash"
      },
      {
        "id": "id",
        "name": "Identity card",
        "only_if": "I pay the visa fee in cash"
      },
      {
        "id": "courtcert",
        "name": "Court certificate",
        "only_if": "I was arrested or convicted"
      },
      "… 9 more"
    ]
  }
}

Can I apply

`visa screening`

Use this command to find which visa fits the user. Returns the screening questions, and once the user has answered them, the visa that fits and its path. Prefer visa eligibility when the user already knows the visa.

Parameters

pathstring: The page's address after /visa/. For example usa.
langen | sq
answersobject: The user's answers, by question id, in the verified answers' shape: {"student": {"value": true}}.

echo '{"answers":{"visa":"B1/B2","residence":"Kosovo"}}' | npx the-a-company visa screening usa

Returns

{
  "path": "usa",
  "visa": "B1/B2",
  "fits": "usa/b1-b2/kosovo",
  "status": "live",
  "verdict": null
}

`visa eligibility`

Use this command to check whether the user can apply for a visa. Returns the eligibility questions, and once the user has answered them, whether they can apply. Prefer visa screening when the user does not know which visa fits yet.

Parameters

pathstringrequired: The page's address after /visa/. For example usa/b1-b2/kosovo.
langen | sq
answersobject: The user's answers, by question id, in the verified answers' shape: {"student": {"value": true}}.

echo '{"answers":{"visit_purpose":true,"no_work_or_study":true,"return_home":true,"trip_paid":true}}' | npx the-a-company visa eligibility usa/b1-b2/kosovo

Returns

{
  "path": "usa/b1-b2/kosovo",
  "url": "https://theacompany.ai/visa/usa/b1-b2/kosovo",
  "lang": "en",
  "can_apply": "yes",
  "verdict": null,
  "parts": [
    {
      "id": "visit_purpose",
      "says": "I am going for business, tourism, or both",
      "question": "Are you going for business, tourism, or both?",
      "holds": true,
      "verified": [
        {
          "key": "visitor_purpose",
          "by": "official",
          "quote": "Visitor visas are nonimmigrant visas for persons who want to enter the United States temporarily for business (B-1 vi…",
          "source": {
            "name": "Visitor Visa",
            "site": "travel.state.gov",
            "href": "https://travel.state.gov/content/travel/en/us-visas/tourism-visit/visitor.html",
            "checked_at": "2026-10-11"
          }
        }
      ]
    },
    {
      "id": "no_work_or_study",
      "says": "I will not work or study for credit",
      "question": "Will you work or study for credit in the U.S.?",
      "holds": true,
      "instead": [
        "F1",
        "J1",
        "H1B"
      ],
      "verified": [
        {
          "key": "not_permitted",
          "by": "official",
          "quote": "These are some examples of activities that require different categories of visas and cannot be done while on a visito…",
          "source": {
            "name": "Visitor Visa",
            "site": "travel.state.gov",
            "href": "https://travel.state.gov/content/travel/en/us-visas/tourism-visit/visitor.html",
            "checked_at": "2026-10-11"
          }
        },
        {
          "key": "no_work",
          "by": "official",
          "quote": "An individual on a visitor visa (B1/B2) is not permitted to accept employment or work in the United States.",
          "source": {
            "name": "Visitor Visa",
            "site": "travel.state.gov",
            "href": "https://travel.state.gov/content/travel/en/us-visas/tourism-visit/visitor.html",
            "checked_at": "2026-10-11"
          }
        }
      ]
    },
    {
      "id": "return_home",
      "says": "I will come back after my trip",
      "question": "Will you come back after your trip?",
      "holds": true,
      "verified": [
        {
          "key": "more_documents",
          "by": "official",
          "quote": "Additional documents may be requested to establish if you are qualified. For example, additional requested documents …",
          "source": {
            "name": "Visitor Visa",
            "site": "travel.state.gov",
            "href": "https://travel.state.gov/content/travel/en/us-visas/tourism-visit/visitor.html",
            "checked_at": "2026-10-11"
          }
        }
      ]
    },
    "… 1 more"
  ]
}

The visa

`visa steps`

Use this command to get the steps to apply for a visa from one country. Returns each step in order, verified, with its quote and source. Prefer visa documents when the user asks what to bring.

Parameters

pathstringrequired: The page's address after /visa/. For example usa/b1-b2/kosovo.
langen | sq

npx the-a-company visa steps usa/b1-b2/kosovo

Returns

{
  "path": "usa/b1-b2/kosovo",
  "url": "https://theacompany.ai/visa/usa/b1-b2/kosovo",
  "lang": "en",
  "steps": [
    {
      "position": 1,
      "id": "ds160",
      "name": "Fill in the DS-160 application",
      "text": "The DS-160 is the online application for a U.S. visitor visa. It is on ceac.state.gov, the Department of State's site…",
      "href": "https://ceac.state.gov/GenNIV/",
      "verified": [
        {
          "key": "application.url",
          "value": "https://ceac.state.gov/genniv/",
          "by": "official",
          "quote": "The DS-160, Online Nonimmigrant Visa Application form, is for temporary travel to the United States, and for K (fianc…",
          "source": {
            "name": "DS-160: Online Nonimmigrant Visa Application",
            "site": "travel.state.gov",
            "href": "https://travel.state.gov/content/travel/en/us-visas/visa-information-resources/forms/ds-160-online-nonimmigrant-visa-…",
            "checked_at": "2026-10-11"
          }
        },
        {
          "key": "ds160_english",
          "by": "official",
          "quote": "All questions must be answered in English using English-language characters only, except when you are asked to provid…",
          "source": {
            "name": "Step 2: Complete the DS-160",
            "site": "ustraveldocs.com",
            "href": "https://www.ustraveldocs.com/xk/en/step-2",
            "checked_at": "2026-10-22"
          }
        },
        {
          "key": "ds160_before_booking",
          "by": "official",
          "quote": "You must submit your DS-160 application online prior to making an appointment for an interview at the Embassy or Cons…",
          "source": {
            "name": "Step 2: Complete the DS-160",
            "site": "ustraveldocs.com",
            "href": "https://www.ustraveldocs.com/xk/en/step-2",
            "checked_at": "2026-10-22"
          }
        },
        "… 6 more"
      ]
    },
    {
      "position": 2,
      "id": "pay",
      "name": "Pay the U.S. visa fee ($185)",
      "text": "The visa application fee. It is paid from your profile in the online appointment system. By card online, in euros or …",
      "href": "https://www.ustraveldocs.com/xk/en/payment-options",
      "verified": [
        {
          "key": "fee_rules",
          "by": "official",
          "quote": "Notice: Every visa applicant must pay the visa application processing fee for the visa category being applied for, un…",
          "source": {
            "name": "Fees for Visa Services",
            "site": "travel.state.gov",
            "href": "https://travel.state.gov/content/travel/en/us-visas/visa-information-resources/fees/fees-visa-services.html",
            "checked_at": "2026-10-11"
          }
        },
        {
          "key": "payment.method",
          "by": "official",
          "quote": "Online Payment with a Credit/Debit Card in local currency\nCash at VFS VAC in local currency",
          "source": {
            "name": "Bank and payment options, Kosovo",
            "site": "ustraveldocs.com",
            "href": "https://www.ustraveldocs.com/xk/en/payment-options",
            "checked_at": "2026-10-22"
          }
        },
        {
          "key": "fee_pay_vfs",
          "by": "official",
          "quote": "Any nonimmigrant visa applicant can pay the visa application fee in cash at the VFS Visa Application Center, located …",
          "source": {
            "name": "Payment locations, Kosovo",
            "site": "ustraveldocs.com",
            "href": "https://www.ustraveldocs.com/xk/en/payment-locations",
            "checked_at": "2026-10-12"
          }
        },
        "… 9 more"
      ]
    },
    {
      "position": 3,
      "id": "book",
      "name": "Schedule the U.S. visa appointment",
      "text": "The interview appointment. It takes place at the U.S. Embassy in Pristina. You book it online, on the official appoin…",
      "href": "https://www.ustraveldocs.com/xk/en/step-4",
      "verified": [
        {
          "key": "appointment.url",
          "value": "https://www.ustraveldocs.com/xk/en/step-4",
          "by": "official",
          "quote": "If an in person interview is required, you can schedule an appointment online using this website",
          "source": {
            "name": "Schedule your appointment, Kosovo",
            "site": "ustraveldocs.com",
            "href": "https://www.ustraveldocs.com/xk/en/step-4",
            "checked_at": "2026-10-22"
          }
        },
        {
          "key": "booking_receipt",
          "by": "official",
          "quote": "The reference/receipt number is required to schedule your appointment.",
          "source": {
            "name": "Bank and payment options, Kosovo",
            "site": "ustraveldocs.com",
            "href": "https://www.ustraveldocs.com/xk/en/payment-options",
            "checked_at": "2026-10-22"
          }
        },
        {
          "key": "fee_before_booking",
          "by": "official",
          "quote": "If you do not pay the exact amount indicated on the deposit slip in local currency, you will not be able to schedule …",
          "source": {
            "name": "Payment locations, Kosovo",
            "site": "ustraveldocs.com",
            "href": "https://www.ustraveldocs.com/xk/en/payment-locations",
            "checked_at": "2026-10-12"
          }
        },
        "… 3 more"
      ]
    },
    "… 6 more"
  ]
}

`visa price`

Use this command to get what a visa from one country costs. Returns the government fee and The A Company's price, each as value and currency, verified, with its quote and source, and the Stripe link to pay. Prefer visa apply when the user is ready to apply.

Parameters

pathstringrequired: The page's address after /visa/. For example usa/b1-b2/kosovo.
langen | sq

npx the-a-company visa price usa/b1-b2/kosovo

Returns

{
  "path": "usa/b1-b2/kosovo",
  "url": "https://theacompany.ai/visa/usa/b1-b2/kosovo",
  "lang": "en",
  "prices": [
    {
      "id": "visa-fee",
      "name": "Fee for the U.S. visa for tourism and business (B1/B2)",
      "to": "U.S. Department of State",
      "price": {
        "value": 185,
        "currency": "USD",
        "per": "per applicant"
      },
      "note": "Paid to the U.S. Department of State. Not refunded if the visa is refused.",
      "verified": [
        {
          "key": "visa.price",
          "value": 185,
          "unit": "USD per applicant",
          "by": "official",
          "quote": "Non-petition-based nonimmigrant visa (except E): $185.00",
          "source": {
            "name": "Fees for Visa Services",
            "site": "travel.state.gov",
            "href": "https://travel.state.gov/content/travel/en/us-visas/visa-information-resources/fees/fees-visa-services.html",
            "checked_at": "2026-10-11"
          }
        },
        {
          "key": "fee_rules",
          "by": "official",
          "quote": "Notice: Every visa applicant must pay the visa application processing fee for the visa category being applied for, un…",
          "source": {
            "name": "Fees for Visa Services",
            "site": "travel.state.gov",
            "href": "https://travel.state.gov/content/travel/en/us-visas/visa-information-resources/fees/fees-visa-services.html",
            "checked_at": "2026-10-11"
          }
        }
      ]
    },
    {
      "id": "dhl",
      "name": "DHL's service",
      "to": "DHL",
      "price": {
        "value": 10,
        "currency": "EUR"
      },
      "note": "Delivery of your passport with the visa to your home. Only if the visa is approved.",
      "verified": [
        {
          "key": "courier.price",
          "value": 10,
          "unit": "EUR",
          "by": "official",
          "quote": "If your visa is approved, your passport(s) will be mailed back to your local address via DHL.\nto provide your contact…",
          "source": {
            "name": "Passport/Visa collection locations and timings, Kosovo",
            "site": "ustraveldocs.com",
            "href": "https://www.ustraveldocs.com/xk/en/collection-locations",
            "checked_at": "2026-10-12"
          }
        }
      ]
    },
    {
      "id": "service",
      "name": "The A Company's service",
      "to": "The A Company",
      "price": {
        "value": 55,
        "currency": "EUR",
        "per": "per applicant"
      },
      "note": "Filling in the DS-160, paying the fee, booking the appointment, and preparing the documents. Paid to The A Company, w…",
      "verified": [
        {
          "key": "service.price",
          "value": 55,
          "unit": "EUR per applicant",
          "by": "the_a_company",
          "source": {
            "name": "The A Company",
            "href": "https://theacompany.ai/visa/usa/b1-b2/kosovo",
            "checked_at": "2026-10-28"
          }
        },
        {
          "key": "service.payments",
          "value": [
            "…"
          ],
          "by": "the_a_company",
          "source": {
            "name": "The A Company",
            "href": "https://theacompany.ai/visa/usa/b1-b2/kosovo",
            "checked_at": "2026-10-28"
          }
        }
      ]
    }
  ],
  "rate": {
    "usd_per_eur": 1.1195,
    "date": "2026-10-14",
    "href": "https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html"
  },
  "pay": "https://buy.stripe.com/8x200ifxP27s0gc6Y02sM2a"
}

`visa wait`

Use this command to get today's wait for a visa interview appointment at the embassy for that path. Returns the wait, the day the State Department updated it, and the day The A Company checked it. Prefer visa steps when the user asks how to book.

Parameters

pathstringrequired: The page's address after /visa/. For example usa/b1-b2/kosovo.
langen | sq

npx the-a-company visa wait usa/b1-b2/kosovo

Returns

{
  "path": "usa/b1-b2/kosovo",
  "url": "https://theacompany.ai/visa/usa/b1-b2/kosovo",
  "lang": "en",
  "wait": {
    "value": 15,
    "unit": "days"
  },
  "updated": "October 21, 2026",
  "checked_at": "2026-11-10",
  "verified": [
    {
      "key": "appointment.wait",
      "value": 15,
      "unit": "days, under (published: < 0.5 Month)",
      "by": "official",
      "quote": "Last updated: 21-OCT-2026\n| Pristina | NA | < 0.5 Month | < 0.5 Month | < 0.5 Month | < 0.5 Month |",
      "source": {
        "name": "Global Visa Wait Times",
        "site": "travel.state.gov",
        "href": "https://travel.state.gov/content/travel/en/us-visas/visa-information-resources/global-visa-wait-times.html",
        "checked_at": "2026-11-10"
      }
    },
    {
      "key": "wait_updated",
      "value": "October 21, 2026",
      "by": "official",
      "quote": "Last updated: 21-OCT-2026",
      "source": {
        "name": "Global Visa Wait Times",
        "site": "travel.state.gov",
        "href": "https://travel.state.gov/content/travel/en/us-visas/visa-information-resources/global-visa-wait-times.html",
        "checked_at": "2026-11-10"
      }
    }
  ]
}

`visa documents`

Use this command to get the documents a visa from one country needs. Returns each document as required, optional or conditional, verified, with its quote and source. Prefer visa photo when the user asks only about the photo.

Parameters

pathstringrequired: The page's address after /visa/. For example usa/b1-b2/kosovo.
langen | sq
answersobject: The user's answers, by question id, in the verified answers' shape: {"student": {"value": true}}.

npx the-a-company visa documents usa/b1-b2/kosovo

Returns

{
  "path": "usa/b1-b2/kosovo",
  "url": "https://theacompany.ai/visa/usa/b1-b2/kosovo",
  "lang": "en",
  "documents": [
    {
      "id": "passport",
      "name": "Passport",
      "need": "required",
      "text": "Your current passport. It must be valid for at least six months beyond your stay."
    },
    {
      "id": "ds160",
      "name": "DS-160 confirmation",
      "need": "required",
      "text": "The confirmation page you get when you submit the DS-160, from ceac.state.gov. Printed. The embassy opens your applic…"
    },
    {
      "id": "appointment",
      "name": "Visa appointment confirmation",
      "need": "required",
      "text": "The appointment confirmation letter, with the date, time and place, from the appointment system. Printed."
    },
    "… 28 more"
  ],
  "verified": [
    {
      "key": "documents.appointment",
      "by": "official",
      "quote": "In addition to these items, you must present an interview appointment letter confirming that you booked an appointmen…",
      "source": {
        "name": "USTravelDocs",
        "site": "www.ustraveldocs.com",
        "href": "https://www.ustraveldocs.com/xk/en/business-visa",
        "checked_at": "2026-10-15"
      }
    },
    {
      "key": "documents.bank",
      "by": "official",
      "quote": "Also bring evidence of financial support such as monthly bank statements, fixed deposit slips, or other evidence.",
      "source": {
        "name": "USTravelDocs",
        "site": "www.ustraveldocs.com",
        "href": "https://www.ustraveldocs.com/xk/en/business-visa",
        "checked_at": "2026-10-15"
      }
    },
    {
      "key": "documents.civil",
      "value": "required",
      "by": "official",
      "quote": "Every visa applicant, no matter their age, must bring certain documents to the interview, including photographs, and …",
      "source": {
        "name": "Step 10: Prepare for the Interview",
        "site": "travel.state.gov",
        "href": "https://travel.state.gov/content/travel/en/us-visas/immigrate/the-immigrant-visa-process/step-10-prepare-for-the-inte…",
        "checked_at": "2026-10-11"
      }
    },
    "… 10 more"
  ]
}

`visa photo`

Use this command to get the photo rules for a visa application. Returns every photo rule, verified, with its quote and source. Prefer visa documents when the user asks about every document.

Parameters

pathstringrequired: The page's address after /visa/. For example usa/b1-b2/kosovo.
langen | sq

npx the-a-company visa photo usa/b1-b2/kosovo

Returns

{
  "path": "usa/b1-b2/kosovo",
  "url": "https://theacompany.ai/visa/usa/b1-b2/kosovo",
  "lang": "en",
  "rules": [
    {
      "key": "photo.printed",
      "value": true,
      "by": "the_a_company",
      "source": {
        "name": "The A Company",
        "href": "https://theacompany.ai/visa/usa/b1-b2/kosovo",
        "checked_at": "2026-10-28"
      }
    },
    {
      "key": "photo_background",
      "by": "official",
      "quote": "Taken in front of a plain white or off-white background",
      "source": {
        "name": "Photo Requirements",
        "site": "travel.state.gov",
        "href": "https://travel.state.gov/content/travel/en/us-visas/visa-information-resources/photos.html",
        "checked_at": "2026-10-11"
      }
    },
    {
      "key": "photo_color",
      "by": "official",
      "quote": "Yes, the photos must be in color. Black and white photos will not be accepted.",
      "source": {
        "name": "Photo Frequently Asked Questions",
        "site": "travel.state.gov",
        "href": "https://travel.state.gov/content/travel/en/us-visas/visa-information-resources/photos/frequently-asked-questions.html",
        "checked_at": "2026-10-11"
      }
    },
    "… 3 more"
  ]
}

`visa validity`

Use this command to get how long a visa is valid for that passport. Returns the months it is valid and the number of entries, verified, with its quote and source. Prefer visa price when the user asks what it costs.

Parameters

pathstringrequired: The page's address after /visa/. For example usa/b1-b2/kosovo.
langen | sq

npx the-a-company visa validity usa/b1-b2/kosovo

Returns

{
  "path": "usa/b1-b2/kosovo",
  "url": "https://theacompany.ai/visa/usa/b1-b2/kosovo",
  "lang": "en",
  "verified": [
    {
      "key": "visa.validity",
      "value": 5,
      "unit": "years (the schedule: 60 Months)",
      "by": "official",
      "quote": "B-1/B-2 | None | Multiple | 60 Months",
      "source": {
        "name": "Kosovo Reciprocity Schedule",
        "site": "travel.state.gov",
        "href": "https://travel.state.gov/content/travel/en/us-visas/Visa-Reciprocity-and-Civil-Documents-by-Country/Kosovo.html",
        "checked_at": "2026-10-11"
      }
    }
  ]
}

`visa sources`

Use this command to list every official page a visa path quotes. Returns each page's name, site, link and the day The A Company checked it. Prefer visa get when the user wants the answers too.

Parameters

pathstringrequired: The page's address after /visa/. For example usa/b1-b2/kosovo.
langen | sq

npx the-a-company visa sources usa/b1-b2/kosovo

Returns

{
  "path": "usa/b1-b2/kosovo",
  "url": "https://theacompany.ai/visa/usa/b1-b2/kosovo",
  "lang": "en",
  "sources": [
    {
      "id": "travel-state-ds160",
      "name": "DS-160: Online Nonimmigrant Visa Application",
      "site": "travel.state.gov",
      "href": "https://travel.state.gov/content/travel/en/us-visas/visa-information-resources/forms/ds-160-online-nonimmigrant-visa-…",
      "checked_at": "2026-10-11"
    },
    {
      "id": "ustraveldocs-schedule",
      "name": "Schedule your appointment, Kosovo",
      "site": "ustraveldocs.com",
      "href": "https://www.ustraveldocs.com/xk/en/step-4",
      "checked_at": "2026-10-22"
    },
    {
      "id": "travel-state-wait-times",
      "name": "Global Visa Wait Times",
      "site": "travel.state.gov",
      "href": "https://travel.state.gov/content/travel/en/us-visas/visa-information-resources/global-visa-wait-times.html",
      "checked_at": "2026-11-10"
    },
    "… 20 more"
  ]
}

Apply

`visa apply`5 a day

Use this command to have The A Company apply for the user: it completes the application for a visa from one country from the user's answers, and asks the user for permission before submitting it. Returns the application id, its link and the link to pay. Prefer visa price when the user only asks what it costs.

Parameters

pathstringrequired: The page's address after /visa/. For example usa/b1-b2/kosovo.
langen | sq
answersobjectrequired: The user's answers, by question id, in the verified answers' shape: {"student": {"value": true}}.

echo '{"answers":{"surname":"Krasniqi","given_name":"Arta"}}' | npx the-a-company visa apply usa/b1-b2/kosovo

Returns

{
  "id": "0e9f3dda-…",
  "key": "pvF_VGbk…",
  "link": "https://theacompany.ai/?application=0e9f3dda-…",
  "pay": "https://buy.stripe.com/…",
  "expires_at": "2026-12-10T…"
}

`visa application get`

Use this command to get an application by its id. Returns its answers and its status. Prefer visa apply when the user has not started one.

Parameters

idstringrequired
keystringrequired: Sent as the x-application-key header, never in the address.

npx the-a-company visa application get <id> --key <key>

Returns

{
  "application": {
    "id": "0e9f3dda-…",
    "answers": {
      "surname": "Krasniqi"
    },
    "mode": "apply"
  },
  "expires_at": "2026-12-10T…"
}

`visa application delete`

Use this command to permanently delete an application and everything in it. Returns the id and that it is deleted. Prefer visa application get when the user only wants to see it.

Parameters

idstringrequired
keystringrequired

npx the-a-company visa application delete <id> --key <key> --confirm

Returns

{
  "id": "0e9f3dda-…",
  "deleted": true
}

Ask

`visa chat`20 a day

Use this command to ask The A Company one question, in any language. Returns the answer and its citations. Prefer the other visa commands when the question is about one visa's steps, price or documents.

Parameters

textstringrequired: For example Sa kushton viza B1/B2?.

echo '{"text":"Sa kushton viza B1/B2?"}' | npx the-a-company visa chat

Returns

{
  "answer": "Viza B1/B2 kushton $185, paguar Departamentit të Shtetit…",
  "citations": [
    {
      "title": "Fees for Visa Services",
      "url": "https://travel.state.gov/…"
    }
  ]
}

Developers

Start

tour

Returns

visa list

Parameters

Returns

visa get

Parameters

Returns

Can I apply

visa screening

Parameters

Returns

visa eligibility

Parameters

Returns

The visa

visa steps

Parameters

Returns

visa price

Parameters

Returns

visa wait

Parameters

Returns

visa documents

Parameters

Returns

visa photo

Parameters

Returns

visa validity

Parameters

Returns

visa sources

Parameters

Returns

Apply

visa apply5 a day

Parameters

Returns

visa application get

Parameters

Returns

visa application delete

Parameters

Returns

Ask

visa chat20 a day

Parameters

Returns

`tour`

`visa list`

`visa get`

`visa screening`

`visa eligibility`

`visa steps`

`visa price`

`visa wait`

`visa documents`

`visa photo`

`visa validity`

`visa sources`

`visa apply`5 a day

`visa application get`

`visa application delete`

`visa chat`20 a day