apply_discount_code
ChatGPTApply a discount code the user gives you to a registration that isn't paid yet.
calculate_cac_fees
ChatGPTCAC's official registration fees, line by line, for a business name, a limited company (by authorised share capital, default ₦1,000,000) or an NGO (Incorporated Trustees). Use it for any question about what CAC charges to register. These are government fees, not FastCAC's price.
check_annual_returns
ChatGPTFor a CAC business name: which annual returns are due from its registration date, which are overdue, CAC's estimated charge, and when the next one is due. Needs the registration date (it's on the certificate). Without it, the annual returns checker on fastcac.com looks the date up by BN number.
check_business_name_compliance
ChatGPTCAC's verdict on a proposed name, the same check fastcac.com's name checker runs: CAC's naming rules first, then CAC's own compliance and similarity engine. Returns tone (ok, caveat = a certificate is needed, blocked), a plain message, code (CAC's 00-14; none when one of CAC's naming rules blocked it), similar_names/most_similar_name/similarity_score, and alternatives: names to offer, each already passing the rules (for a name missing its ending, the name with each accepted ending: Ventures, Enterprises, Services, Concepts, Hub, Fashion, Beauty, Biz, or Limited/Ltd for a company). line_of_business must be one of CAC's entries; anything else returns error line_of_business_invalid with choices to ask about, never a guess. A name ending in Limited/Ltd/PLC is checked as a company unless name_type says otherwise. An error is never a verdict: say CAC didn't answer.
check_name_availability
ChatGPTSearch CAC's public register for names matching or similar to a name, across every registration type (business names, companies, LLPs, trustees), ranked like fastcac.com's public search. CAC rejects a new name that's too close to any of them, active or inactive. exact_match is the registered name that is this name (case, spacing and the legal form like Ltd ignored), or null. close_matches come best first, each with match (exact, close, similar, or null when it only shares a distinctive word); a close match is often the same name with another ending (ADAEZE ENTERPRISES for "Adaeze Ventures"), which CAC treats as a clash. Lead with exact_match when there is one; when it's null, say nothing is registered under this exact name and lead with the closest matches as the clash they are. Any close match means the name is at risk; CAC makes the final call (check_business_name_compliance asks it). For an RC/BN number use search_cac_register instead.
create_business
ChatGPTStart a new registration: creates the business (as a draft) with the name the user wants to register, in the workspace they're in (pass workspace only when they ask for the other one). A personal registration needs a verified WhatsApp number: without one it returns whatsapp_unverified (request_whatsapp_verification sets it up).
create_share_link
ChatGPTMake a share link and show it as a Copy button. If one is already live, this replaces it (the old one stops working), so it shows a Confirm button first. review_enabled (status links) lets the viewer review the registration details.
delete_business
ChatGPTDelete one of their businesses that hasn't been paid for (draft or pending_payment) with its registration details and documents. If it can be deleted, a Confirm button is shown and nothing is deleted until they tap it; if not, you get the reason (e.g. it's been paid for). Call it only when they ask to delete it - not when they just ask whether they can.
fetch_nin_slip
ChatGPTGet their NIN slip for them from NIMC's record for their confirmed NIN, instead of them uploading a photo of it. Free to them. Only after they agree, and only once their NIN is confirmed. The slip is never shown to them.
generate_business_names
ChatGPTBrainstorm CAC-registrable business names for an idea. Each name comes back already checked against CAC's registry, with availability: likely_available, similar_names_exist, or unchecked (CAC's search was busy).
get_action_status
ChatGPTWhether the person finished a step you handed them on FastCAC (a tool returned status 'action_required' with an action_id): confirming a change, paying, uploading documents, entering their NIN or verifying WhatsApp. Returns status (pending, started, completed, failed, cancelled, expired) and next_step in words.
get_cac_documents
ChatGPTFor an approved registration: show Download buttons for the CAC certificate and status report, once we have them.
get_cac_tax_id
ChatGPTGet the Tax ID (TIN) CAC's public search shows for a registered business. Takes company_id, rc_number and classification_id from a search_cac_register result. Returns { name, rc_number, tax_id }, or an error 'not_found' when CAC has none.
get_capabilities
ChatGPTWhat they can do right now and why not: the workspace they're in and who they register for, the Agent subscription (status, renewal, days left), credits, WhatsApp, personal drafts, whether a registration can start in each workspace (and the tool that unblocks it), credit purchases, and features switched on for them.
get_credits
ChatGPTTheir credit balance, recent credit activity, Agent subscription status, and the credit packs they can buy (pack_id for request_credit_purchase).
get_nin_request_status
ChatGPTWhere a request from start_nin_request stands: status (waiting_for_person, started, settling, verified, failed, expired, paid, delivered, delivery_failed), next_step in words, the products and their naira prices. Never the NIN or the person's details: those go only to the person.
get_notification_preferences
ChatGPTHow they get updates: in-app, email, WhatsApp, and WhatsApp tips and offers.
get_prices
ChatGPTFastCAC's own current prices, live: business name registration (personal and agent workspace), the Agent Pro subscription, annual returns (CAC's fee and ours, per year), credit packs, the NIN tools and the developer API. Use it for any question about what FastCAC charges, every time, instead of a price from memory, a page or the knowledge base.
get_registration_state
ChatGPTRead where one of the user's registrations stands: status, stage, next action and action_path, which form sections are done, missing or invalid fields (names only), each document's status and what's wrong with it, payment status, whether their NIN is confirmed, and for a queried registration CAC's reason plus each flagged item with its fix_path and whether it's resolved. It never includes personal details (NIN, date of birth, phone, addresses); those are on the registration page.
get_subscription
ChatGPTTheir Agent subscription: status (none, trialing, active, past_due...) and period end.
list_my_businesses
ChatGPTList the signed-in user's businesses with each registration's stage, the next action, and action_path (the dashboard page for that action).
list_notifications
ChatGPTTheir recent notifications (unread only by default).
list_share_links
ChatGPTA business's share links: the status link (anyone with it sees progress) and the details form link (the owner fills in their own details). Whether each is live, when it expires. Never the link itself.
manage_subscription
ChatGPTShow a button to Paystack's page for changing their card or cancelling the subscription.
mark_notifications_read
ChatGPTMark all their notifications as read.
recheck_documents
ChatGPTRun the checks again on documents that are stuck (e.g. the check service was down, or the NIN slip is waiting on the passport photo). Not for a document that failed - that needs a new upload.
refresh_cac_status
ChatGPTAsk CAC now for the latest on a registration that's with them (submitted or queried). Changes arrive as system events too.
remove_discount_code
ChatGPTRemove the discount code from a registration that isn't paid yet.
remove_whatsapp
ChatGPTRemove their WhatsApp number. Shows a Confirm button first.
rename_business
ChatGPTRename a business (its display name; not allowed once CAC approved it).
request_credit_purchase
ChatGPTShow a Pay button for a credit pack (Agent subscribers). Use a pack_id from get_credits.
request_documents
ChatGPTShow an Upload button for a registration's documents (passport photo, NIN slip, signature, and a supporting document if CAC's name check asked for one). Without document_types it asks for every required document still missing or failed; name document_types to ask for specific ones again (e.g. CAC queried the passport photo). Files never pass through you; each verdict arrives as a system event.
request_nin
ChatGPTShow a secure NIN field for a business so the user can verify their identity. Their name, date of birth and gender are filled from it. The NIN is typed into that field, not into the conversation.
request_payment
ChatGPTShow a Pay button for a registration once its form is complete. The amount comes from FastCAC's pricing (less any discount code applied). You never see card details or the payment link; the outcome arrives as a system event.
request_subscription
ChatGPTShow a Start free trial button for the Agent subscription (for people registering businesses for clients). 14 days free, set up on Paystack.
request_whatsapp_verification
ChatGPTShow a Verify on WhatsApp button. Needed before starting a business or paying (create_business / request_payment return whatsapp_unverified).
revoke_share_link
ChatGPTTurn off a business's share link. Shows a Confirm button first.
search_cac_register
ChatGPTSearch the Corporate Affairs Commission's (CAC) public register for businesses already registered in Nigeria, by name or by RC/BN number. Returns results: name, rc_number (the BN number for a business name), registration_date, classification, nature_of_business, status (e.g. ACTIVE or INACTIVE), company_id, classification_id and match (exact, close, similar or null), best match first; RC/BN numbers ("RC 8911267") are read as numbers. Lead with the result whose match is exact; when none is, say plainly that nothing is registered under that exact name before listing the closest. This lists what exists; it isn't an availability check (check_name_availability and check_business_name_compliance are). An error never means there's no match.
search_knowledge_base
ChatGPTSearch FastCAC's knowledge base: the articles, policies, guides and how-tos FastCAC's team has written (pricing and what it includes, refunds, timelines, documents, what happens after payment, CAC rules and procedures, post-registration steps). Use it before answering a question about FastCAC's service or CAC process that the instructions above don't settle, and answer from the passages, not memory. Returns passages best first, each with its document title, heading, updated_at, a 0-1 rank score and a 0-1 similarity (how close in meaning; about 0.7 and up answers the question), plus total_matches and has_more. Weak or no results: try mode 'broad', reword the query, or page on with offset. If it still has nothing, say plainly that you don't have that information.
search_line_of_business
ChatGPTFind exact entries in CAC's line-of-business picklist matching what the business does.
set_share_review
ChatGPTTurn on or off the 'review the details' section on a business's live status link.
show_share_link
ChatGPTShow a Copy button for a business's live share link.
start_nin_request
ChatGPTStart a paid request on fastcac.com for: 'slip' = the person's NIMC NIN slip (PDF and print-ready image), using their NIN; 'phone' = the person's NIN, found with the phone number they registered with NIMC (on fastcac.com they can add the slip; you can't request it here). Returns a link for the person and a request_handle for you. The person does a live face check and pays on fastcac.com (₦1,000 for the slip; ₦500 for the NIN, ₦1,200 with the slip); the result goes only to them. Starting is free and charges nothing.
switch_workspace
ChatGPTSwitch the dashboard between their Personal workspace (their own businesses) and the Agent workspace (businesses they register for clients; needs the subscription).
update_notification_preferences
ChatGPTTurn update channels on or off. Only pass the ones they asked to change.
update_profile
ChatGPTChange their account name (first and/or last name). Not a registration's proprietor name.
update_registration_fields
ChatGPTSave registration form fields from what the user told you. Only these fields can be set: proposedOption1 (Proposed business name), lineOfBusiness (Line of business (exact CAC picklist entry)), proprietorPhonenumber (Phone number (digits only)), proprietorEmail (Email), proprietorState (State), proprietorLga (LGA), proprietorCity (City), proprietorStreetNumber (Street number), proprietorServiceAddress (Street name / address), proprietorPostcode (Postcode (digits only)), companyState (Company state), companyCity (Company city), companyStreetNumber (Company street number), companyAddress (Company street name / address), companyEmail (Company email). Returns what saved, anything invalid, and what's still missing.
use_nin_photo_for_passport
ChatGPTUse the photo from their confirmed NIN record as the passport photograph instead of uploading one. Only after they agree, and only once their NIN is confirmed.